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SECTION 1 



INTRODUCTION 

This manual provides information on the B80 CMS MCP, 
with specific reference to the 3.01 release. It is intended 
for systems software support personnel, for use when analysing 
problems and as a guide to the analysis of memory dumps. 

The taking of memory dumps and the use of PMB80 to print out 
selected information is explained. The output of PMB80 is 
discussed in detail. 

Section 4 recommends a method of approach to a systems problem 
on the CMS B80. The subsequent sections explain the memory 
organisation, and the main features of the MCP which help 
towards a general understanding of the system. This is 
necessary in order to understand a memory dump. 

Section 10 presents details on disk organisation which apply to 
all CMS systems. 

The analysis of datacomm areas and the investigation of problems 
in the B80 Stand Alone Utility are not discussed. 

The codes used in the tables to specify the format of MCP maps 
are explained in Table 1.1.1. The bit numbering convention 
followed, is that the most significant bit of a byte is niambered 
7 and the least significant bit is numbered 0. 

The Appendix gives an index of terms used in the body of this manual 
manual, and explains the meaning of the commonly-used acronyms. 

This information should be used by all persons involved in the 
diagnosis of CMS B80 system problems and the support of the 
system software. 
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TABLE 1.1.1 - FORHAT CODES USED IN TABLES 



ABBREV. FORMAT CODE 



A 
E 
BCD 

B 

eR 



ASCII 

EBCDIC 

BCD 

CINARY 

(5YTE REVERSED 



fA 


ABSOLUTE ADDRESS 


PA 


RELATIVE ADDRESS 


SR 


SELF RELATIVE 


I 


INDEX 


S 


SUBSCRIPT 



L LABEL 

NOTE NOTE n 
TABLE TABLE n.n.n 



MEANING 

inforiation stored in ASCII colUting sequence 
inforwtion stored in EBCDIC collating sequence 
inforaation stored in Binary Coded Deciaal foraat 
inforsation stored in binary 
binary inforaation stored byte reversed 
fiost significant byte at highest aeniory address (on the right) 

field contains an absolute aemory address 
a aeaory address relative to soae base 
a aenory address relative to the field 
a byte indeK into a field or tap 
a subscript in a table 

the field naae does not reference a field of data 
but is used to label a aesory address 
refer to the note at the base of the table 
refer to the appropriate table in this newsletter 



FORMAT CODES USED IN TABLES 
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SECTION 2 



TAKING MEMORY DUMPS 

It is very important that a memory dump is taken each time 
an unexplained failure of the MCP occurs. It is equally 
important that the dump is taken properly and contains 
useful information. This section clarifies the memory 
diamp procedures. 

Memory dumps may be taken on either cassette or disk. 
After the system has initialised (either automatically, 
or by using the initialise button inside the cabinet) , 
the system is in the initial state with PKl and PK2 lit. 
If PK2 is pressed, the ROM bootstrap loads the disk 
bootstrap to memory. PKs 3, 4, 5 & 6 are then enabled. 
If PK4 is pressed, then the contents of memory may be 
dumped to cassette; PKS will cause the contents of memory 
to be dumped to disk. 

The contents of a memory dump are only useful if the MCP 
had previously been running. Dumps taken after the Stand 
Alone Utilities have been running are of no use. Also, if 
PKl is pressed when PKl & PK2 are enabled in the initial 
state, then memory is cleared and memory dump taken after 
this is of no use. 

If an error condition arises during the memory dump routine 
then a pattern of PK-lights will be lit indicating the 
error (see tables 2.1.1 and 2.2.1). The error should be 
corrected, the system initialised again, and the memory 
dump re-attempted. The memory dump routine destroys the 
contents of only a very few memory locations (see Table 6.1.1) 
and repeated attempts at dumping the contents of memory may 
be made without destroying further information. 



2.1 MEMORY DUMP TO CASSETTE 

If PK4 is pressed while the system is in the bootstrap- 
loaded state, then the bootstrap routine attempts to 
dump the contents of memory to cassette. Tne numeric 
keyboard is enabled and a drive number (1-4) must be 
keyed. The number 1 indicates the drive referenced by 
the mnemonic CTA by the MCP, and so on. 
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TAKTMC; MEMORY DUMPS CCONT.') 

2.1 MEMORY DUMP TO CASSETTE (CONT. ) 

If the memory dump routine encouters an error condition, 
then an indication of the fault is given on the key-board 
lights (see Table 2.1,1). The error should be corrected, 
the system initialised again, and a second attempt should 
be made to dump the contents of memory. 

A memory dump cassette has the format of a single file CMS 
tape with a label of MEMDUMP /MEMORY and a record and block 
size of 256 bytes. 



2.2 MEMORY DUMP TO DISK 

If PK5 is pressed while the system is in the bootstrap- 
loaded state, then the bootstrap routine attempts to dump 
the contents of memory to disk. The memory dximp routine 
does not create a file on disk, but uses a file already 
present. A search is made on disk for a file called 
MEMDUMP and then the contents of memory are written to this 
file until either the end of memory is reached or the disk file 
is full. 

The MEMDUMP file is created on disk by the utility GEN.DUMPFL. 
It has a record and block size of 180 bytes, and a default 
filesize large enough to hold 65KB of memory. A larger 
MEMDUMP file may be created by using an initiating message 
with GEN.DUMPFL. For example: "GEN.DUMPFL 128" will create 
a MEMDUMP file large enough to hold 128 KB of memory. 

If the memory dump routine encounters an error condition, then 
an indication of the fault is given on the key-board lights 
(see Table 2.2.1). The error should be corrected, the system 
initialised again, and a second attempt should be made to dump 
the contents Oj. memory. 

If there is more than one disk on the system which 
holds a MEMDUMP file, then confusion may arise about 
which file contains the latest d\imp. To avoid this 
confusion, it is recommended that a disk is set aside 
which contains a MEMDUMP file of the required size. 

Before a memory dump is taken, all other disks should 
be removed and this disk should be loaded. 

Before this disk is re-used, the dump should be analysed 
or the MHyiDUMP file copied to another disk for subsequent 
analysis. 
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TABLE 2AA - MEHORY DUfiP TO CASSETTE - ERROR CONDITIONS 



The fo! 'owing conditions causa the error light to be tit when i 
iTECory dufflp is being tak-en on cassette :- 

The cassette drive nusfaer Iceyed does not exist 
The cassette drive does not hold a cassette 
The cassette is not writs enabled 

To recover the situation/ correct the error/ hit reset and retry. 



TASLE 2.2,1 - MEMORY DUHP TO DISK - ERROR CONDITIONS 
EfiROR &-Hghts PK- lights 



cnannej address PKfe=off 

no fiEfiUUMP file on disk 1-8 at I lit PKA=off 

HMUm file too saali channel address 9-B ail on 

fressed PK3 not PK4 all off all off 

ihannel address on B-lights :- Dl=channci 0/ D5=chjnnel i etc. 



MEMORY DUMP TO CASSETTE - ERROR CONDITIONS, .and 
MEMORY DUMP. TO DISK ^^^ ERROR CONDITIONS 
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SECTION 3 



PRINTING MEMORY DUMPS 

It is possible to list a memory dump file in hexadecimal 
and perform the analysis by hand. This however, is a laborious 
approach, and is not usually required. The CMS B80 system 
includes a memory dump analyser called PMB80. 

PI'jBoO is a sophisLicateu Loul £ur atjlecting and printing infor- 
mation from a system dump file. It also performs some dump 
analysing functions by highlighting suspected errors, but it is 
best to confirm these errors by checking the data. 

This section presents the features of PMB80 used in memory dump 
analysis. 



3.1 PMB80 AND ITS WORKFILES 

The system dump analyse utility consists of the program 
PMB80 and four reference files PMBHELP, PMBERROR, PMBM.nnnnn 
and PMBO.nnnnn. 

Each major release of the BBO system contains all of these 

■Ft 1 o c Tn arli^T -H t ,-.•»-> -i -F +-1-».r-» -Pz-v i..-tm -^ 4- ^-v 1 ^^-j-^' «« ^4= A*/-'!-. 4.-,Wi -. « 

(known as MCP "maps") changes with a new version of the MCP, 
then the Map and Offset files PMBM.nnnnn and PMBO.nnnnn are 
re-released with the MCP with a new value of nnnnn to identify 
the MCP version. 

The PMBHELP file contains the syntax of the PMB80 commands, 
and is used to provide the HELP function. 

The PMBERROR file contains the messages output by the dump 
analyser. It may be listed by the LIST utility to provide 
a list of all possible messages. 

The PMBM.nnnnn file holds the format and names of the field 
of the MCP Maps. The PMBO.nnnnn file holds the memory Offsets 
of these maps. 
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3. PRINTING MEMORY DUMPS (CONT.) 

3.1 PMB80 AND ITS WORKFILES (CONT.) 

The nnnnn represents the mark, level and patch numbers 
of the corresponding MCP code file. For example with 
the 3.01 MCP, the value of nnnnn is 30100. PMB80 can 
analyse memory dumps of different levels of the MCP. It 
selects the appropriate Map and Offset files with reference 
to the field VERSION of map INTERGLBL (Table 7.1.1). 

If an attempt to execute PMB80 results in "NO FILE" messages 
for the Map and Offset files with unrecognisable names, the 
the VERSION field is likely to be corrupt. This could be 
a first indication that the memory dump does not contain 
useful information. 



3.2 



STARTING PMB80 - THE INITIATING MESSAGE 



The utility can be executed with a number of options, 
selected by the initiating message as follows: 



PMB80 



GET 
ON 
AX 



< disk-id > 



riin uptluns proviue tne luxxowj-iiy j-eduurtitj ; 

GET - This option is used to specify the file-id of a disk 
memory dump other than "MEMDUMP" (the default value) . 

ON - This option is used to specify the disk-id of the disk 
containing the memory dump file, if other than the 
system disk. 

AX - This option instructs PMB80 to communicate with 
the operator via DISPLAYS and ACCEPTS. If this 
option is not specified, then a CONSOLE file is 
used. 

If a disk file called MEMDUMP and a cassette file labelled 
MEMDUMP /MEMORY are both present, then PMB80 takes the disk 
file as input. 
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3. PRINTING MEMORY DUMPS (CONT.) 



3.3 



ir-ruDOW Ui-lXUiNO rtVHlJ_irt£iij£j 



The Utility does not print or analyse automatically. The 
functions of PMB80 are provided on command from the operator, 
The options available are as follows: 




HELP 



PRINT 



-DISPLAY 

- CHECK ■ 

- PATCH - 

- SAVE - 
• END — 
■ BYE — 



n 



< PMB80 option >■ 
<r print option r^ ■ 

^ cnGCK opiion ^ ~ 

< patch option > - 
<saveoptlon> ' 



3.3.1 THE HELP OPTION 

The HELP option of PMB80 lists the PMB80 options 
available. If a particular PMBBO option is included 
(e.g. HELP PRINT) then the syntax and explanation of 
the various functions of that option are given. 
Functions can be described in further detail by 
specifying other options, (e.g. HELP SLICE will give 
details of the PRINT SLICE function) . 



3.3.2 THE PRINT AND DISPLAY OPTIONS 

These options control the printing and analysis of 
selected information. 

The PRINT option is the most useful option of PMBBO 
and is explained in greater detail in section 3.4. 

The DISPLAY option provides the same features as the 
PRINT option, but uses the SPO instead of a PRINTER. 
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PRINTING MEMORY DUMPS (CONT.) 



3.3 PMB80 OPTIONS AVAILABLE (CONT. 



3.3.3 THE CHECK OPTION 

This option has the following syntax: 



CHECK 



MEMORY.LINKS 
-ALL.MEMORY- 



This command instructs PMB80 to analyse the contents 

of the memory dump and report on any errors encountered. 

The MEMORY.LINKS option causes PMB80 to check the 
structure of overlayable memory (see section 6.4.1). 
The ALL. MEMORY option instructs PMB80 to check the 
complete memory structure, and some fields are also 
checked for valid contents. 

It should be noted, however, that it is not feasible 
for PMBBO to perform a complete analysis of all 
possible faults. Therefore this option may report an 
error where no real error exists. Consequently, all 
faults reported by PMBBO should be verified by checking 
the data concerned. 



3,3.4 THE PATCH OPTION 



This option has the following syntax: 



<- 



PATCH 



Lone J 



NEXT 



<hex address > 



<hex value > 
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3. PRINTING MEMORY DUMPS (CONT.) 

3.3 PMB80 OPTIONS AVAILABLE (CONT.) 
3.3.4 THE PATCH OPTIO N (CONT.) 
ONE 



SAVE 



- specifies that the patch is to be 

performed on page one (extended memory) 

NEXT - specifies that this patch is to follow 

directly after the previous patch. 

<hex-address> - is four hexadecimal digits with no 
delimiters. 

<hex-value> - is from one to 16 hexadecimal digits. 



^'w'J-lill^ ^.L1-/1X 



which limits the extent of useful analysis that can be 
performed by PMB80. 

The PATCH option enables the operator to correct invalid 
areas of memory, enabling PMB80 to continue its analysis. 
The patches are applied to an internal PMB80 work file, 
leaving the original dump file unchanged. 

The modified dump file may be saved using the SAVE option 
(see section 3.3.5). If this action has been taken, 
details should be documented when reporting a problem, and 
both the original and patched dump files should be submitted. 



3.3.5 THE SAVE OPTION 



The syntax for this option is : 



1 n H 

I AS— <file-id> —I l_ON _ < disk-name> — I 



AS - This option allows the operator to specify 

the file-id of the memory dump file which is 
saved. The default value is "MEMDUMP". 

ON - This option allows the operator to specify 

the disk-id of the disk on which the dump file 
is to be saved. If this option is not used, then 
the dump file will be saved on the system disk. 



3.3.6 THE END AND BYE OPTIONS 

Either of these options will cause PMB80 to go to 
end of job (EOJ) . 
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3. PRINTING MEMORY DUMPS (CONT.) 
3.4 THE PRINT OPTIONS 

The options available within the print command are as follows: 



PRINT 



MIX 



■MEMORY.MAP- 



MEMORY.LINKS- 

< map name> 

GLOBAL 



OL- 



PHT 



SLICE 
TASK- 



ALL.MEMORY- 
HEX 



< pht option > 

< slice option > 

< task option> 



< hex option > 



When starting analysis of a memory dump, it is recommended 
that items are printed in the order in which they are given 
above. 

The MIX option provides information on the tasks that were 
running. If a hardware problems is suspected, then the OL 
and PHT options provide information on the state of peripheral 

options in more detail. 



3.4.1 THE PRINT MIX OPTION 

This option provides a selective analysis of information 
contained in the global MCP map GLBLM (Table 7.6.1) 
and the TASK. TABLE (Tables 8.2.1 and 8.2.2). 

A list is given of the tasks running at the time of the 
dump, what status these tasks were in, and which tasks 
(if any) held locks to non re-entrant MCP code. Since 
the TASK. TABLE is an overlayable segment of t±ie Bailiff 
Slice (Slice O) the task names may not be available on 
the memory dump. 
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PRINTING MEMORY DUMPS (CONT.) 
3.4 THE PRINT OPTIONS (CONT.) 

3.4.2 THE PRINT MEMORY. MAP OPTION 

This option provides an analysis of the layout of memory. 
The contents of the five sections (RESIDENT, LOCKED, 
OVERLAYABLE, PHT, EXTENDED) are listed in the order in 
which they occur. If any faults such as overlapping fields 
are detected, then a message is printed. 

It is always advisable to check such error messages 
carefully. Sometimes the overlap is not a real error 
(for example: Zero length segments may legally overlap; 
sometimes the LOADER (slice 15) locates its segments 
within its CONTROL STACK; the INITIALISE (slice 18) slice 
descriptor may overlap since it is not used; 
etc.) . 

The analysis of the locked and overlayable areas 
is performed through the SAT, slice descriptors and 
Data Segment Tables (see Section 6.3). Any error 
reported in this part of the analysis implies an 
error in one of these structures. 



3.4.3 THE PRINT MEMORY. LINKS OPTION 

This option analyses the layout of the OVERLAYABLE 
AREA of memory. The analysis is performed through 
the memory link mechanism described in Section 6.4. 
Anv error renorted wi +-h -i-hic: r-,T^+-^/-^n nr,^-! r^ = -i-^^ j-u„ 

— J. - - — -■ —*.-.*- w^ . — i-v^i* -i-±A^*j.\*t-t»^^;:o one:: 

corruption of this structure. 

If the system was performing virtual memory operation 
when the dump was taken, then the memory links are 
likely to be in a transient state and no conclusion can 
be drawn from apparent errors. In this condition, the 
PRINT MIX option will show the VMLOCK to be held by a 
task. 



3.4.4 THE PRINT GLOBAL OR PRINT < map name> OPTION 

This option causes MCP tables to be printed in a map 
format. A map is a "template" which the MCP uses to 
define its data structures. The <map name>s available 
are: 

GWA : Global Work Area. See Table 7.1.1 - 

INTERGLBL MAP, and Section 7.1. 
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3 . PRINTINT MEMORY DUMPS (CONT . ) 

3.4 THE PRINT OPTIONS (CONT.) 

3.4.4 TH E PRINT GLOBAL OR PRINT map name OPTION (CONT.) 
PHDMP 



Peripheral Handling dump area. See 
Table 7.2.1 and Section 7.2. 



DIAGNOSTICS 



VMWA 



ESCT 



SCL 



See Table 7.4.1 - DIAGCBUF MAP and 
Section 7.4. 

Virtual Memory Work Area. See Table 
7.5.1 and Section 7.5. 

Execution Scan Table. See Table 7.6.1 - 
GLBLM MAP, and Section 7.6. 

Slice Address Table. See Table 6,2.1 
SATM Map and Section 6.2. 

See Tables 8.1,1 and 8.1.2 and Section 8.1. 
This table is overlayable and therefore 
may not be present in memory. 

Configuration Table. See Table 9.1.1 - 
CT MAP, and Section 9.1. This table is 
overlayable and therefore may not be present 
in memory. 

The PRINT GLOBAL option will cause the global MCP tables 
(INTERGLBL, PHDMP, VERSIONINFO, DIAGCBUF, VMWA, GLBLM, 
SCL, CT.INFO, SAT) to be printed. 



TASK. TABLE 



C, TABLE 



3.4.5 THE PRINT OL OPTION 

This option provides a selective analysis of information 

contained In the C. TABLE (Table 9.1.1). This includes the 

peripherals configured on the system, any media loaded on 

the peripherals, and the status of the peripherals. The 

C. TABLE is overlayable and so this analysis may not be possible, 

3.4.6 THE PRINT PHT OPTION 

This option enables the printing of the Peripheral 
Handling Table for selected device types present 
on the system. The syntax is: 



PRINT PHT 



< device mnemonic> 
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PRINTING MEMORY DUMPS (CONT. ) 
3.4 THE PRINT OPTIONS (CONT.) 

3.4.6 THE PRINT PHT OPTION (CONT.) 

Valid <device mnemonic>s include: 

DF - Fixed Disk 

DK - Disk Cartridge 

DM - Burroughs Super Mini Disk 

LP - Line Printer 

SP - Serial Printer 

SS - Self Scan 

KB - Keyboard 

CT - Cassette 

CX - Channel Expander 

DI - Industry Compatible Mini disk 

ADC - Async. Data Comm 

SDC - Sync. Data Coram 

For each <device mnemonic) specified, all the PHTs 
for devices of that type are printed. If no <device 
mnemonic> is entered, then all the PHTs in the diamp 
are printed. 

In addition to printing the PHTs, this option prints 
the I-O queues, queued descriptors, and keyboard, console 
and SPO buffers (where applicable). Sections 9.2 and 
9.3 discuss these tables in more detail. 



3.4.7 THE PRINT SLICE OPTION 

This command prints the contents of selected slices 
(see section 6.3 for a description of memory slices) 

The syntax is : 



PRINT SLICE 



u 



< slice optio 



:m: 



DATA.SEGMENTS 



3 



DATA.SEGMENTS - This option prints the contents of 

the data segments in the overlayable 
area. If this option is not used, then 
only the contents of the locked slice will 
be printed. 
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-> -n-OTK-rvTr-jn MVMHPV DUMPS ^CONT . ^ 



3.4 THE PRINT OPTIONS (CONT.) 

3.4,7 THE PRINT SLICE OPTION (CONT.) 

Values for <slice option^ include 
0-48 



: Any number in this range refers to a slice 
See Table 6.2.1 - SATM MAP 



SUSN : (Slice 12) Super Utility TCB (data) 

OPENCLOSE : (Slice 17) File Open & Close MCP code 

INITIALISE : (Slice 18) Warmstart MCP code 

SPO : (Slice 19) SPO printing MCP code 

LPDDR : (Slice 20) Line printer DDR code 

CASSDDR : (Slice 21) Cassette DDR code 

DISKDDR : (Slice 22) Disk DDR code 

SENDDR : (Slice 23) 60 cps Serial Printer DDR code 

KBDDR : (Slice 24) Keyboard DDR code 

SCREENSN : (Slice 25) Self -Scan/CRT DDR code 

ADCDDR : (Slice 26) Async. Data Comm DDR code 

SDCDDR : (Slice 27) Sync. Data Comm DDR code 

DCCH : (Slice 28) Data Comm Communicate Handler 
MCP code. 

CONSOLE : (Slice 29) Console Communicate Handler 
MCP code 

PANDDR : (Slice 20) 180 cps and 120 cps Serial 
Printer DDR code 

INKS : (Slice 31) Indexed file Comm Handler 
MCP code 

ICMDDDR : (Slice 33) ICMD DDR code 

CONBUFSN : (Slice 35) Console Buffer data slice 

SCLBUFSN : (Slice 36) SCL Buffer data slice 
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3. PRINTING MEMORY DUMPS (CONT.) 

3.4 THE PRT>JT OPTIONS (CONT.) 

3.4.7 THE PRINT SLICE OPTION (CONT.) 



If no <^lice option> is specified, then all the slices will 
be printed in the order in which they reside in the locked 
area. 



Items which may be included in the analysis of a 
loaded slice are : 



MAP RS 

PIELD S.I.W A 



Slice Descriptor (see Table 6.3.1) 

" Interpreter Wurk Area (in program 
TCBs only) (see Tables 8.2.1 and 
8.3.1). 



FIELD CCBPA2 



- COP table (COBOL/RPG CCBs only) 
FIELD CONTROL STACK - TCBs only (see table 7.4.2). 
^^■^^ ^° - Segment Descriptor (see Table 6.4.1) 



If the DATA. SEGMENTS option is selected then further items 
discussed in Section 8 may be encountered. 



3.4.8 THE PRINT TASK OPTION 

This command prints the contents of a Task Control Block 
(TCB) (see Section 8). The syntax is: 



1^ 



PRINT TASK 



-CURRENT 



L 



< task type > 



<number> — 
■ < task name > • 
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3. PRINTING MEMORY DUMPS (CONT.) 



3.4 THE PRINT OPTIONS (CONT.) 

3.4.8 THE PRINT TASK OPTION (CONT . ) 

Options for <task. name> include: 

BAILIFF : Slice O, MCP code 

MCS : Slice 13 , MPLII s-code 

NDL : Slice 14, NDL s-code 

SCL : Slice 15, MCP code (including LOADER) 

LOADER : Slice 15, MCP code (including SCL) 

<number> : must be the mix number of a task in the 
range 0-15 

CURRENT : causes the printing of the task which was 
executing prior to the dump being taken. 
This is the task referenced by field EICT 
of map GLBLM (Table 7.6.1) , and may be part 
of the cause of the dump. 

<task type) enables further analysis of the S-Interpreter 
Work Area (SIWA) . If the option is not 
selected then the SIWA is printed as a single 
block of data. 

Options available include: 

* COBOL S-machine (see Table 8.2.1) 



COBOL 
RPG 



MPLII 
BIL 

SORT 

NDL 



BIL S-machine (see Table 8.3.1) 

Sortintrins microcode (refer to MCP listing) 
NDL s-machine 



If no option is specified for the PRINT TASK 
command, then all tasks in the dump are printed. 

In addition to printing the TCB, the PRINT TASK 
option prints the associated Program Control Block 
(PCB) and Interpreter Control Block (ICB) , wherever 
applicable. See section 8 for further details of 
these task structures. 
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3. PRINTING MEMORY DUMPS (CONT.) 

3,4 THE PRINT OPTIONS (CONT.) 

3.4,9 THE PRINT. ALL MEMORY OPTION 



This option prints the entire contents of the 
memory dump. It is printed in a format equivalent to a 
command of PRINT GLOBAL PHT SLICE. Memory not in use 
is not printed. Although this option prints all of 
memory it is not recommended; selective options may 
considerably reduce the volume of printed output. 

NOTE : It is not sufficient to include only this printout 
when siabmitting problem reports. Useful information may 
be contained in memory areas not in use. This is especially 
true if memory links are corrupt. When submitting a 
problem report containing a memory dump, the complete dump 
on cassette, disk or load/dump tape should therefore be 
included. An accompanying listing of the PRINT MIX 
GLOBAL OL PHT option is useful for initial analysis. 



3 . 4 . lO THE PRINT HEX OPTION 

This option provides the operator with a printout 
of selected areas of the dump file. The option has 
the syntax: 



PRINTHEX— ^ <,,3^> <,^^g^,> 

I ONE 1 



ONE 



: This option selects page one (extended) 
memory for printing. 



<start> : This parameter must be four hexadecimal 

digits long (no delimiters) and indicates 
the memory address of the first byte to be 
printed. 

<length^ : This parameter must also be four hexadecimal 

digits long. It indicates the number of bytes 
to be printed. 

The contents of the memory dump are printed in hexadecimal 
and ASCII format. 
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SECTION 4 



INITIAL DUMP ANALYSIS 



This section discusses the approach to analysing memory dumps. 
Firstly, the type of problem must be identified. Once this 
is done, some general analysis should be performed which may 
lead to deeper analysis of selected parts of the dumn. 



4.1 IDENTIFYING THE PROBLEM 

Problems can be partially analysed by considering the 
symptoms. The operating environment (what tasks/programs 
were running) , and the configuration environment (what 
devices were in use) may indicate the general nature of 
the problem. First of all, the following categories 
should be differentiated. 



4.1.1 ALL PK-LIGHTS FLASHING 

This is known as the memory parity condition. 
It occyrs when the processor fetches a byte from 
memory which has a parity error. In this situation 
a complete memory dump cannot be taken since the 
problem will occur again when the dump is being taken. 
However, a memory dump taken to cassette will proceed 
up to the bad memory address and therefore locate 
the problem. 

Note that memory dump files on disk are not initialised 
to any specific pattern; consequently, the end of the 
dumped information cannot easily be located on a 
MEMDUMP file. 

The memory parity condition may also be caused by a 
system software failure. The ROM at the low address 
end of memory contains a deliberate permanent parity 
error as a check on interpreter failures when accessing 
beyond segment boundaries. Therefore, if no memory 
hardware fault can be located, the current task should be 
analysed (see Section 4.2.2). 
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INITIAL DUMP ANALYSE (CONT.) 
4.1 IDENTIFYING THE PROBLEM (CONT.) 
4.1.2 SOME PK-LIGHTS FLASHING 



When the MCP detects an irrecoverable error 
condition, it sets PK-lights 17 to 24 flashing 
in a pattern which identifies the problem. Refer 
to section 5.4 for details. 

If analysis does not reveal faulty hardware or 
corrupt media, further analysis may be performed 
to isolate the environmental conditions under which 
the problem occurred. If more than one dump with 
similar symptoms exist, analysis often gives a clue 
to the cause. 



INITIALISATION TO PK-LIGHTS 1 AND 2 

This is caused by the execution of the microcode 
(§0000009, which passes control to the start of 
memory. The first thing to look for in a memory 
dump taken after this condition, is corrupted memory. 
If there appears to be no corruption, then a general 
analysis as discussed in section 4.2 should be followed. 



4.1,4 NO RESPONSE TO KEYBOARD INPUT (NO ACTIVITY) 

In this condition, the MCP gives no response to 
depressing any key, including the Ready Request- Key. 
This may be due to a peripheral problem, or the MCP 
might be in a tight loop. The global diagnostic area 
(see Section 7.4) should distinguish the two cases. 

Since the keyboard is associated with the console printer, 
a printer jam will cause this symptom. The PHT of the 
serial printer should be examined if this is a suspected 
cause of the dump. 



4.1.5 NO RESPONSE TO KEYBOARD INPUT (D-LIGHTS FLICKERING) 

It may not be possible to enter data or obtain a response 
from depressing the Ready Request- Key, but the system 
may still look "busy" because of D-light activity. 
This problem is often caused by system thrashing. 
This can result from an attempt to execute too many 
programs in insufficient memory, or an attempt to 
execute a program with exceptionally large segments. 
In this case, the organisation and contents of memory 
should be examined. 
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4. INITIAL DUMP ANALYSIS (CONT.) 

4.1 IDENTIFYING THE PROBLEM (CONT.) 

4.1.6 NO PROGRAM RESPONSE TO "GO" OR "PS" INPUT 

In this condition, no action appears to be taken by 
a program when a "GO" or "DS" message is entered for 
that program, although all other activity appears to 
be normal. This is usually caused by the program hanging 
on a dedicated peripheral (i.e. not disk). In this case 
the task status should be examined in the memory dump. 

4.2 PRELIMINARY INVESTIGATION 

be PRINT MIX MEMORY. MAP MEMORY. LINKS GLOBAL OL PHT (see section 3), 
This provides a wide range of information without producing an 

CiVi^QQQ-l TTO ^ TYl /-\ n ■M -I- r> -F i-ii^-! ■l-.-^-.-^/l y-i, -1 1 -I- v^ * 1 4- 

4.2.1 HARDWARE STATUS 

The OL and PHT options of PMB80 print this information. 
It is recommended that a check is always made on the 
status of the devices involved in any problem (see 
section 9.2). An invalid status may not necessarily cause 
a system problem, but unexpected conditions may arise 
which cause a failure. 

The device status in the CT (PRINT OL option) is 
a logical status as seen by the MCP; this may not 
exactly correspond with the physical hardware status. 
The PHT holds the last status received from the channel 
controller. 



4.2.2 MEMORY ORGANISATION AND CONTENTS 

The PRINT MEMORY. MAP MEMORY. LINKS option of PMB80 
provides a complete analysis of the layout of memory. 
Section 6 describes the format of memory with no error 
conditions. All reports of overlapping areas in 
memory should be investigated. If the Virtual Memory 
lock is held by a task (section 7.6.2) , then overlayable 
memory may contain an invalid link. 
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4. INITIAL DUMP ANALYSIS (CONT.) 

4.2 PRELIMINARY INVESTIGATION (CONT.) 

4.2.2 MEMORY ORGANISATION AND CONTENTS (CONT.) 

Shortage of overlayable memory may be the cause of a 
number of performance problems, especially system 
thrashing. If a dump is taken because of poor 
performance, then the amount of overlayable memory 
should be checked. For a rough guide, at least 10 KB 
is required as "free space" to enable virtual memory 
to perform efficiently. Large program code or data 
segments can cause similar problems. Although it is 
not possible to specify an exact limit, as a rough 
guide it may be stated that user program segments of 
4K bytes are too large, especially on the B80 in a 
multi -programming environment. 

Section 7 discusses the global maps; these should be 
checked for valid contents. 

The PRINT PHT option of PMB80 analyses the I-O descriptor 
queues. Since the queue heads lie at the high address 
end of memory, an incomplete memory dump will provide 
an incorrect analysis of this structure. 



4.2.3 MCP STATUS 

The status of the MCP when the memory dxrnip was 
taken can be obtained from an analysis of the global 
maps (section 7) . The diagnostic area in particular 
is designed with this purpose in mind. The analysis 
of the GLBLM MAP and TASK. TABLE (PRINT MIX option 
of PMB80) provides a general overview of the task 
environment. 



4.2.4 USER TASK STATUS 



Task structure analysis is provided by the PRINT 
TASK option of PMBBO, and discussed in section 8. 
To avoid producing a large amount of printed output 
without much relevant information, it is recommended 
that the current task is analysed first. The current 
task is the task running when the memory dump was 
taken. The most important information, other than the 
integrity of the task structure, is the communicate 
parameter area. This indicates the latest call on 
MCP routines (open file, read etc.) that was requested 
from the task. 
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SECTION 5 



SYSTEM REGISTERS AND TRACE DIAGNOSTICS 

The B80 MCP is written in microcode, consequently extensive 
reference is made throughout this newsletter to the hardware 
registers of the B80 processor. This section documents the 
format and usual contents of these registers. 






The B80 MCP i^rovides a "ensral tra"^"^ -p-,--,-! i -i 

the GT command. The trace is used for system fault diagnosis. 
Even when the trace is not in operation, a memory dump includes 
a historical buffer of one byte containing trace diagnostic 
information (see section 7.4). Sections 5.2 through 5.4 describe 
trace diagnostics . 



5.1 



SYSTEM REGISTERS 



5.2 



Table 5.1.1 shows the format of information in the 
processor registers, and their possible contents. 
Although a memory dump does not necessarily contain 
the contents of the registers at the time of the dump, 
the following points should be noted. 

The PHDMP MAP (Table 7.2.1) stores the current contents 
of the registers after two types of event. When a 
physical interrupt is received from an I-O channel, the 
processor executes the Master Interrupt Processor (MIP) 
section of the MCP. The registers are dumped on entry to 
the MIP in order that processing can resume, after the 
interrupt has been serviced, from the point of interruption. 
The registers are also dumped to the PHDMP MAP if the general 
trace is running (see section 5.2) or the system failed 
with a trace diagnostic (section 5.4) . 

THE GT COMMAND 



GT 



The general trace command is an MCP intrinsic which displays 
various diagnostic information either on the system console 
printer or on a line printer. The format is: 



■ON - 
OFF 



< printer peripheral > 
< diagnostic class > 



< switch value > 
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5. SYSTEM REGISTERS AND TRACE DIAGNOSTICS (CONT.) 
5.2 THE GT COMMAND (CONT.) 

The ON and OFF options switch the trace on or off 
respectively. The <printer peripheral> selects the 
device to print any trace messages. If this device 
is currently in use, the trace messages are interleaved 
with other printed output. Table 5.2.1 shows the 
<diagnostic class>es which are further explained in the 
sections which follow. 

The MCP contains calls to the trace routine throughout 
the code. However, trace diagnostics are printed only 
when two conditions are fulfilled; (a) when the trace 
is switched on, and (b) when the level of the switch 
value for that class is less than or equal to the level 
of the trace point. The <switch value> consists of two 
hexadecimal digits, with the following meanings: 

first digit : switch value for register diagnostics 
second digit : switch value for memory diagnostics 

In addition to providing a printed trace of selected 
trace points, the general trace displays a one-byte 
diagnostic (the contents of the AD register) on PK lights 
17 to 24 (PK17 corresponding to the most significant bit 
and PK24 the least significant bit. If the PK light is 
lit, the corresponding bit value is 1. These lights 
display the last trace point encountered if the trace 
option is switched on and the keyboard is not enabled 
for input. 



5.3 TRACE DIAGNOSTICS 

Trace information provided by the B80 MCP consists of 
three parts: 

register diagnostics 
memory diagnostics 
one-byte diagnostics 

Register diagnostics are made to a selected printer and 
the contents of the registers are entered in PHDMP (table 
7.2.1) when the trace is switched on and the switch value 
is lower than the trace point value for that class. 
Memory diagnostics are made to a selected printer when the 
same conditions are satisfied. One-byte diagnostics are 
displayed on PK lights 17 to 24 whenever the trace is 
switched on and the keyboard is not input enabled. The 
most recent one-byte diagnostic processed by the MCP can 
be found in the field DIAGCIRC of map DIAGCBUF (Table 7.4.1) 
regardless of the state of the trace or switch values. 
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SYSTEM REGISTERS AND TRACE DIAGNOSTICS (CONT. ) 
5.3 TRACE DIAGNOSTICS (CONT.) 

Printed register diagnostics have the following format: 

register AD BO BlFL B32 J K L 
contents XX XX XXXX XXXX XXXX XXXX XXXX 

Ml M2 WR X Y AD,ESCT 
XXXX XXXX XXXX XXXXXXXX XXXXXXXX XXXX 

(the actual print is on one line) . AD contains the one-byte 
diagnostic consisting of two hexadecimal digits. The first 
digit represents the diagnostic class (see Table 5.2.1) the 
second digit represents the diagnostj c severity value which is 
compared with the switch value set by the GT command. ESCT 

is t'bp ono >-iTr-(-Q +-=ioV_T/^ ^rp^KT .-. n c n\ _^ 4-u _ . ■■ 

executing task (as displayed on the keyboard D-lights) . 

A general rule on the interpretation of the diagnostic 
severity value is the following: 

(zero) is the least important 

B is used when a module is entered (eg: DB.= VM module entry) 
E is used when a module is exited (eg: EE= EPAR module exit) 
F is associated with an error condition (not necessarily fatal) 

Actual details vary according to the coding of the various MCP 
modules . 



5.3.1 FILE OPEN AND CLOSE - CLASS O 

These diagnostics are issued by the OPENCLOSE MCP 
slice 17, which performs operations requested by a 
task via the communicate mechanism. There are so 
many possible interpretations of each severity value 
that it is not possible to give a guide to interpretation 
of register diagnostics beyond OB = entry and OE = exit. 
Memory diagnostics in this class often print a DFH, 
an FIB or an FPB. 

If class O diagnostics appear in DIAGCIRC it is possible 
that the problem is related to opening or closing a file. 
Possible faults include media corruption (disk directory, 
program S-code files) , or memory corruption of the FPB. 
These possibilities may be checked from a memory dump or 
by running utilities such as KA and CHECK. DISK. The 
task which initiated the operation may hold one of the 
openclose locks (see section 7.6) and the task's communicate 
area (in SIWA) will indicate a verb of 01 = open or 
02 = close (see table 8.4.1). 
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5 . SYSTEM REGISTERS AND TRACE DIAGNOSTICS (CONT . ) 
5.3 TRACE DIAGNOSTICS (CONT.) 

5.3.2 INDEXED FILE HANDLING - CLASS 1 

These diagnostics are issued by the MCP index 
communicates slice 31. A value of IB indicates 
slice entry, and IE indicates slice exit. This 
slice performs operations requested by a task via 
the communicate mechanism. 

5.3.3 ACCEPT/DISPLAY/DATE/TIME - CLASS 2 

These diagnostics are issued by the MCP SPO slice 19 
which processes communicates with a verb in_ the range 
(§10(3 - (§20(3 (see Table 8.4.1). 

5.3.4 INTRINSIC UTILITIES - CLASSES 3-7 

The SORTINTRINS microcode uses these classes. 



5.3.5 AUTOMATIC VOLUME RECOGNITION - CLASSES 8-9 

Class 8 diagnostic is used by the general AVR routine 
(OPENCLOSE segment 18) ; class 9 is used specifically 
by the routine which "tidies up" a disk directory at 
AVR time (OPENCLOSE segment 19) . If AVR entries 
are found in DIAGCBUF of a memory dump, it is quite 
likely that the problem has been caused by faulty hardware 
or media. In addition to recognising newly loaded media, 
the AVR routine is used when certain exceptional events 
occur on hardware Ciianne_L3 • 

5.3.6 DISK SPACE ALLOCATION/DE-ALLOCATION - CLASS A 

This class of diagnostics is issued by OPENCLOSE segments 
20 and 21 which perform the disk space allocation and 
de-allocation functions respectively. (see Table 5.3.6). 

5.3.7 INTERPRETERS - CLASS B 

This class of diagnostics is reserved for the 
interpreter microcode. However, only the BILINTERP 
(MPLII program interpreter) uses the facility 
extensively. 

This class of diagnostics is very useful tracing an 
MPL program. See table 5.3.7 for the details. Note 
that BB and BE do not indicate interpreter entry and 
exit in this case. 
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SYSTEM REGISTERS AND TRACE DIAGNOSTICS (CONT. 
5.3 TRACE DIAGNOSTICS (CONT.) 

5.3.8 COMMUNICATE HANDLING - CLASS C 



The global MCP routine for decoding all communicates 
from tasks uses this class of diagnostics. See Table 
5.3.8. 



5.3.9 VIRTUAL MEMORY - CLASS D 

The Virtual Memory (VM) routine uses this class of 
diagnostics. A trace of the virtual memory operations 
is not generally needed as a lot of detailed analysis 
is involved. However, when a disk problem occurs the 
VM routine is often the first part of the MCP to 
detect the error. This is the reason why the DF failure 
diagnostic (section 5.4.2) is often encountered. 



5 . 3 . lO TASK CONTROL (EPAR) - CLASS E 

There are not many trace points with this class. Most 
important is the EE diagnostic, issued when the task 
schedules are exited. This indicates which task has 
been entered and which code is currently executing 
(see section 7.4) . 



5.3.11 I NPUT/OUTPUT QUEUE HANDLING - CLASS F 

iiiis Ca.a3s oj. trace diagnostic shows the queueing 
of I-O descriptors, and the waiting of tasks on 
these 1-0 operations. In the register diagnostics 
the registers hold the fields of the 1-0 descriptor 
being queued. (See Table 5.3.11). 



5.4 FAILURE DIAGNOSTICS 

When the MCP discovers that an irrecoverable error has 
occurred, it issues a failure diagnostic. On previous 
systems this was a printed trace diagnostic. On release 3,01 
a failure diagnostic is a pattern of flashing PK lights. 
PK lights 17 to 24 show the one-byte diagnostic of the 
failure with PKs 17 to 20 showing the diagnostic class. 

When this situation occurs, a memory dump should be taken 
(see section 2). The PHDMP MAP (Table 7.2.1) contains the 
contents of the processor registers at the time of the failure. 
The value of the one-byte diagnostic indicates the rough 
nature of the problem; the contents of the registers give 
more specific information. 
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5. SYSTEM REGISTERS AND TRACE DIAGNOSTICS (CONT.) 
5.4 FAILURE DIAGNOSTICS (CONT.) 

5.4.1 AC, AD (PK patterns lOlOllOO, 10101101) 

AC and AD on PK lights 17-24 indicate a fatal error 
detected while allocating or de-allocating disk file 
space respectively. The Ml register holds the memory- 
address of the last disk I-O descriptor and BO holds 
lODFL (see Table 9,3.4). This problem is usually 
caused by disk hardware or disk media problems. 



5.4.2 DF (PK pattern llOlllll) 

More than one type of error is detected by the VM 
subsystem. These are distinguished by the contents 
of the Ml register (see Table 5.3.9), 

If Ml=llll or 5555, an 1-0 error has been encountered 
on a virtual memory operation. Refer to the VM 1-0 
descriptor (field VMIOD of MAP VMWA, Table 7.5.1), 
This indicates a problem with the disk drive or disk 
media. 

If m2=2222, then the MCP has attempted an invalid 

"put segment" operation. If Ml=FFFF then an unconditional 

"get" operation has failed (not caused by an 1-0 error) . 

If either of these problems persists after the system 

(including user programs) has been recovered from backup 

copies, then a fault may exist in the MCP and should be 

reported. 



5.4,3 EF (PK pattern lllOllll) 

Different errors identified by this failure diagnostic 
are distinguished by the contents of the Ml register 
(see Table 5,3.10). If any of these problems persist 
after the system has been recovered from backup copies, 
then the problems should be reported. 



5.4,4 FF (PK pattern 11111111) 

This error diagnostic is used to show errors in 
peripheral handling. The WR register identifies 
the device type involved (see Table 5.3,11), The 
PHT entries for the device should be checked for a 
bad status condition (section 9,2). This may identify 
a hardware fault. If no hardware fault is located, 
the problem should be reported. 
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TABLE 5.1.1 - SYSTEH REGISTER USES 



fEB FORhAT USE 



fi) 1 BYTE (i) I-O chantiet address (see TABLE 9.?. 8) 

<fi) One byte diagnostic class jnd severity valaa 
BO 1 BYTE usuaty contains a flag byte accardi!!g to the situation :- 

(i) peripheral stitus hyt-: (see TABLES 9.5.4 to 9.2.8) 

<i() M'R s-ftags (see TABLE 9.5.9) 

<fii) 1-0 descriptcr flags (see TABLE 9.3.4) 

(iv) slice descriptor flags (see TABLE 6.Z.2) 

(v) segisent descriptor flags (see TABLE 6A.2) 

two (usualy independant) bytes used for flags as fiO 

a two byte work area or a sesiory address 

used for storing a dieinary address 

a fiaaory address :- 

(i) address of the task slice descriptor on eKit froa EPAR (SECT 7.4) 

<(() address of she PHT when hIP is handling an interrupt (SECT P.?) 
2 BYTES (i) flieiEory address of a table involved in data eoveffient 

<ii) used in diagnostics as a further indication of the type of error 
^e 2 BYTES as Ml 
Wi 2 BYTES (i) separate 1 byte work are.^s 

(ii) used by the diagnostic routine as for Hi 
XY 8 BYTES (i) sigaent descriptor for virtual lueiaory operations 

<i()CofflBun!cate Parameter Area on entry to HCH 
EBCT 1 BYTE this is not a processor register but is the last two digits 

of a trace diagnostic. It is the task-id byte of the current task 

See SECTION 7.4 



BiFL 2 BYTES 

BJ?. 2 BYTES 

K 2 BYTES 

L 2 BYTES 



m 



SYSTEM REGISTER USES 
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TAeiE 5.?.1 - TRACE DIAGNOSTIC CLASSES 
Q.ASS USE 

file OPEN and CLOSE (HCP slice naisber 1?) 

1 IN&EXES file coMiunicate handling (ttCP til ice 31) 

2 ACCEPT; DISPLAY/ BATE and TIfiE coffliwnicate handling (slice 19) 
3-7 used by S0RTI«TR1NS 

8 AutoMtic Volusie Recognition (AVR) (HCP Usk 9; and slice 17) 

9 AVR and BAILIFF («CP task 0) 

A disif space ALLOCATION and DE- ALLOCATION (slice 17 segsents 20, ?1) 

B INTERPRETERS (aostly SILINTER?) 

C COtMhUNICATE handling (NCK in global HCP, and DDR slices) 

D Viftua! Hefflory oparatians (global HCP) 

E Task control (EPAR in global HCP) 

F I-O queue handling (global fiCP) 



TRACE DIAGNOSTIC CLASSPS 
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WM 


5.3.1 - CLASS = FILE OPEN AN'D CLOSE 


DIA& 


mrommm 


m 


entry into oiia of the open or close routines 


<E 


exit froffi one of the open or close routines 


imif 


5,3=? - CLASS ! - IMl'EXEB FILE CGHHUHICATE HANDLING 


MAG 


INFORMATION 


10 


delated entry found/ or end of area entry found 


11 


suspending the operation 


19 


searching through the keys 


13 


cosparing the keys 


14 


set up overflow region search bufff"- 


15 


set up indeK region search buffer 


U 


access work area key 


17 


fill th>3 entry ('ML = key entry size) 


18 


store the entry (URL = key entry size) 


19 


end of the free slot sliding the buffer up 


lA 


call HIP to queue the I-O descriptor 




fiO=IODI)U .(E=writ2/ F=read) (TABLE ?.3.3) 


IB 


entry into the index coisas routine 




D>l'RL=coffiaunicate verb; B1=IFLAGS 


IE 


exit from the index coffiins routine 




B1=FILESTAT£ (TABLE 8.6.3) 



CLASS - FILE OPEN AND CLOSE and 
CLASS 1 - INDEXED FILE COMMUNICATE HANDLING 
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TABLE 5.3.3 - CLASS 2 - ACCEPT, DISPLAY; DATE AND TIfiE 
DIA6 I«FOP,HATION 



2i~2^ DISPLAY cosfflunitate eKecutlar. 

27-28 ACCEPT coiMunicAle eKecatioR 

2f? TIME and DATE coaaiun i cate exacati>3n 

2B entry into the CLASS C CoMunicjta handling code 

3: SKft -fioiR the routine 

3' error conditions 

e07UR=Fetch Cosiiiunicate Message (TABLE 8.4.2) 

E32=^FrFF => fatal error 



TABLE 5.3.4 - CLASSES 3-7 - INTRINSIC UTILITIES 
^43 in-forfflatioR 



CLAgS 2 - ACCEPT, DISPLAY, DATE AND TIME and 
CLASSES 3-7 - INTRINSIC UTILITIES 
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TABLE 5.3.5 - CUiSSES 8-9 AUTOfiATIC VOLURE RECOGNITION 

WA5 INFORKATIOK 

80 set up dfsfc configuration Ubfe 
8S XY=«FIB 

&t update the I-O Q head flags in the PHT 
^a->PHTH, WRK1QHD0 

85 DDR found on non-disk AVR 
K==«2=DSR si ice nufiiber 

86 used in &ISi( AVR 
8^" device not in use 

ftt->QFL 
88 device in use 

CP nmmnn PrAflV /MnT DTARV . ,. 

SA start the AVR operation 

Ei=QFL/ «1->PHTH£'; k'RL=PHT«QNO 
8B AVR code entry/ iook for the channel requiring help 
8E exit froiB AVR routine 
8F 1-0 error during AVR 

97 search Disk File Headers and set u-:;er counts to zero 

98 search KAHELIST far temporary entries 

9ft enter- fina! phase of disk directory cieanup 

98 enter disk directory cleanup routine 

9E exit cleanup/ relinquish the openclose lock and return to caller 

millFF DIAGNOSTICS 



9P nn cMrac cMjannjiftln /ClJADDtJT- 



9A in GETSLICE operation WRL=SMAFCNT 

in PUTSLICE operation eO=SUAPCNT 
9C 6ETSLICE operation after the slice lock has been procured 

PUTSLICE operation after the slice lock has been procured 



91) 



CLASSES 8-9 - AUTOMATIC VOLUME RECOGNITION 



2015400 



5-11 



TABLE 5.3.6 - CLASS A - DISK ALLOCATION AND DE-ALLOCATIOK 
DIA6 INFORflATIOH 



A1. B1=1)DU (disk unit), m-HM (disk address) 

fQ initiate disk I-O 

Bi-lW, e3?=I0DFL (1-0 descriptor flags), «R=DDA 

At B32=J}FH bitaap 

A5 B32=size of area 

fG CKit no space, 80=DDU, XY=size rsqaire-i 

fiB determina the area required 

fC de-allocate fatal failure, 80=IQDFL, Ml-MODFL 

m allocate fatal failure, eO=IODFL, Hl-MODFL 

iC eKit froffl the allocate sr de-allacata routine 

ff allocation or de-allocation failure (no user disk) 



TABLE 5.3.7 - CLASS 8 - BILINTERP DIAGNOSTICS 
DIA6 INFORHATIOfi 



EB user generated coMunicate 

associated aeiiiory trace prints the CPA 
EC call of a procedure within the current segaient 

E3?=procedure nufiberssegisent number of the called procedure 
H) procedure return 

S3?=proc8dure nuaberssegaient nuaber of the procedure returned to 

lH=byte offset (byte reversed) in procedure 
£E call of procedure in another segaient 

£fJ?=procedure nuefaerssegaent nusiber of the called procedure 
F DS/DP error 



CLASS A - DISK ALLOCATION AND DE-ALLOCATION and 
CLASS B - BILINTERP DIAGNOSTICS 
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TABLE 5.3.8 - CLASS C - COHHUMICATE HANDLIfIG DIA5N0STICS 
WAG IHFOR«ATIO« 



O) start of class A cam processing 

&>V9rb (TABLE 8.4.1); ei=FILESTATE (TAeLE e.6.3> 

fcRL=filetechniq-is (TADLE 8.6,4), fi32->CPA 
CI start read-wnte sequential and stream buffering ahead 

K)=fi testate, Xi>verb, e3.2=5uffef length, 8i=I0DfL (TABLE 5.3.4) 
C8 previous buffer = current buffer 
C3 full buffer foun on sequential read 

El=fil8 technique, n2~>mmi (TABLE 9.3.3) 
C4 zero a buffer 
CS Bark buffers as einpty 



i^/ -.i-...t.i.- Li.- j;-i. -J -I 



BO=disk unit, E'i=area nuaber, 832=sector address 
C7 return froai buffer searcti 

Bl=80 (found), 61=00 (not found) 
C8 conditional failure due to buffer wait 
0? suspension of the com waiting on I-O 
CA call on 1-0 queue handier to queue an 1-0 descriptor 
OB start of coMunicate handling cods 

E3S->CPfi, XY=CPA (byte reversed) 
CD successful terinination of a class A coaiiMnicate 

K->FI6/ and associated aeMry diagnostic prints FIS 5nd buffers 
CE eKJt froffl ^CH non-class A sequential organisation coffiaunicate 

KiS and HR = top of control stack return info {TA8LE 7.4.2) 
(F coiaaiun i a le fa i i ur s 

Gl,yR=Fetch Cositiunicate fessags (TABLE 8.4.?) 



CLASS C - COMMUNICATE HANDLING DIAGNOSTICS 
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TABLE 5.3.9 - CLASS B - VIRTUAL «E«ORY DIAGNOSTICS 
MAG INFORhATION 



DO start to seirch aeniory -for space 

?t?=start searching address 
11 consider the segscnt 

?iB=current address 
DP space found at last Dl diagnostic 
D3 set up the segment descriptor 

Kl=start of area, «?=iength of the segscnt; eO=SDFLAG (TABLE 6A.2) 
lyi adjust the nsefflory link 
EG «ake an area of Jieiiiory available 

Ht=start address; «R= length 
M start virtaal ffieaory I-O 

^{?=base/ K=length, WR=disk sector^ ei=disk unit 

BL)=opcode (eE?0=«rite, er?Q-rcAd) 
D7 iiare areas left to purge 

?e=start address; WR=length; Bl=seg(nent descriptor flags 
EG core to core «iove 

^a.=o!dt)ase; M^-newbase, WR^tength (<C for slide down) 
DB entry into the virtual siemory routine 

fe->Seg(iient desctiptor; XY=SD (TABLE 6AA) 

¥i~2222 iisplies a segtsent (not slice) operation 
U) Getslica failure and thrashing detection 
IE etcit from the virtual (sefflory routine 

MB->SI), XY=SD (byte reversed) 

f)C'=l iaiplies fai lure 
W virtual aeisory fatal error 

fe->SD, XY=SB (byte reversed) 

111=^1111 virtual ffiesory 1-0 error Bl^IODFL 

?ll=8??? systeii! error 

M1=44W EDBASE does not point to link-J-? (raeaiory link error) 

rtl.=5555 as for m=ltll 

M1=FFFF systeai error 



CLASS D - VIRTUAL MEMORY DIAGNOSTICS 
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TABLE 5.3.10 - CLASS E - TASK CONTROL DIAGNOSTICS 
MAG INFi(RHATIO« 



EB entry into Systea Control LangUcige decoder 

L">TCS of orfgiitdtar 
H) slice aser count oyerfiou 
EE SKft froii! op-ir into the current task 

XY=top of stick (TABLE 7.4.?) 

J->aicfocoda -isgacnt bisa/ L->slice descriptor/ ?t->top of stack 
EF fAtai error 

MI=999? segfficnt user count error detected on FUTSE6 

M1=AAAA dttespt to use an afasent si ice 

>fl=6S£'E error in SCL interpreter 



TABLE 5.3.11 - CLASS F - INPUT-OUTPUT QliEOE HAfMING DIAGNOSTICS 
MAG INFORMATION 



for all of these diagnostics CKcept FF the registers hold :- 

BO=IOM'U, B1=I0DFL, e32->I0DFL, Hl=IOi)DA, H2=I0BBL {see TABLE 9.3.3) 
R? unconditional wait on exit after call fros HCH 
FJ! conditional wait on exit after irail froffl HCH 
F4 no wait on exit after non-disk descriptor inserted 
F6 unconditional wait after non-disk descriptor inserted 
F7 conditional wait after non-disk descriptor inserted 
FB no wait on exit after disk descriptor insert 
rA unconditioflai wait on exit after disk descriptor insert 
FB conditional wait on exit after disk descriptor insert 
FF fatal DDR error 

m=0000 invalid disk unit in I-I descriptor BO-IODDtl 

lifi=88S8 Data ccffiS! DDR error 

tR=^99?9 self scan DDR error 

W(=E££E disk DDR error 



CLASS E - TASK CONTROL DIAGNOSTICS and 
CLASS F - INPUT-OUTPUT QUEUE HANDLING .DIAGNOSTICS 
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SECTION 6 



MCP STRUCTURE AND MEMORY ORGANISATION 

It is often necessary to know where certain items may be found 
in memory. Corruption of memory is one of the more common problems 
encountered in an MCP, On some dumps an area of memory is 
over-written with invalid information; on other dumps, just 
one or two critical bytes holding a memory link (address to 
another item) are wrong. PMB80 may be unable to analyse satis- 
factorily a MEMDUMP file containing invalid memory links, since 
it assimies the memory structure is correct. This section provides 
sufficient information to enable a HEX dump to be analysed. A hex 
dump is obtained by the PRINT HEX option of PMB80. 



6.1 AREAS OF MEMORY AND THEIR USES 

The six areas of memory used by B80 3.01 MCP are shown in 
Figure 6.1.1. 

The Read Only Memory (ROM) which has addressed §0000(3 to 
(aoFFF@ contains interrupt handling routines. It appears 
full of binary zeros on a hex dump. 

When the bootstrap routine is loaded to memory it destroys 
the contents of those areas of memory specified in table 
6.1.1. These areas do not contain information which is 
important for dump analysis. 

The other five areas are discussed in sections 6.2 to 6.6. 



6.2 RESIDENT AREA AND GLOBAL MCP 

This contains the global MCP code and data, which does not 
change location while the system is running (see Figure 6.2.1) 
This area of memory contains: 

Global tables (discussed in section 7) 

Global MCP routines: 

Master Interrupt Processor (MIP) 
Master Communicate Handler (MCH) 
Virtual Memory (VM) Handling code 
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MCP STRUCTURE AND MEMORY ORGANISATION (CONT. ) 

6.2 RESIDENT AREA AND GLOBAL MCP (CONT.) 

Global MCP routines: 

Task Structure Switching (EPAR) 

Slice Address Table (SAT) 

Each item is located at a fixed address and the same 
table or code segment can be found at the same address on 
all dumps for the same level of MCP. The code routines are 
not analysed by PMB80. The addresses of the tables may be 
found from either an MCP listing or a correctly analysed 
diunp. 



6.2.1 SLICE ADDRESS TABLE (SAT) 

The SAT is a table of memory address of the next 
section of memory. Each memory address is two 
bytes long and addresses the first byte of the 
Slice Descriptor of a slice in the locked area. 
See Table 6.2.1, SATM MAP, and figure 6.3.1. An 
analysis of the SAT is obtained by the PRINT SAT 
option of PMB80. 



The Locked Area of memory follows directly after the SAT. 
The first slice (the BAILIFF) is at the same memory address 
on all dumps of the same version of the MCP. 

In the locked area, slices are contiguous with no intervening 
areas. Slices may be either present or absent (swapped out) . 
If a slice is swapped out, only the slice descriptor remains 
in memory. When a slice is swapped in or out by the BAILIFF, 
all other items in the locked area are moved up or down in 
memory so that all slices remain contiguous. 

An analysis of the layout of memory is obtained by the PRINT 
MEMORY. MAP option of PMB80. 
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6. MCP STRUCTURE AND MEMORY ORGANICATION (CONT.) 
6.3 LOCKED AREA AND SLICES (Cont'd) 
6,3.1 SLICES 

A slice is a body of code or data which provides 

a specific function. Examples of slices are: 

the MCP routine to handle the SPO (slice 19) , the 

data comm message buffers (slice 34) , the data 

associated with a task (program) in the mix 

(slices 1-14) , or the code associated with a task 

in the mix (slices 39-49) . A slice does not necessarily 

contain its own data, but rather controls access to 

its data which is located in the overlayable area of 

memory. The different types of slices have several 

features in common. 

The first ten bytes of each slice is a slice 
descriptor (see Table 6,3.1, RS MAP). This descriptor 
contains information about the status of the slice 
(SDFLAG, SDUSRS) , the size and location of the disk 
copy (SDLENG, SDDKAD, SDDKSC, and SDUNIT) and the 
PINK LINK. 

The slices are linked together in the order in which 
they reside in memory. This is not in slice number 
order, the order of SAT. The PINK LINK is the memory 
address of the first byte of the next slice descriptor. 
This scheme of linking the slice descriptors is used to 
relocate memory slices when slices are swapped in or out. 

A slice is either a Code Control Block (CCB) or a Task 
v,<>iii_j.wj. ijj.vjv,rv \x<^n>/ . n \^\^D may jje ci uevice uepenaent 
Routine (DDR) , a Function Dependent Routine (FDR) , an 
Interpreter Control Block (ICE) or a Program Control 
Block (PCB) . A TCB holds the control information for a 
task. 



6.3.2 DEVICE DEPENDENT ROUTINE (DDR) 

Each hardware device (disk, cassette, line printer, 
etc.) supported by the B80 has a section of MCP code 
which handles all features unique to the device. 
This code is accessed through a DDR slice. Each 
different device type has its own DDR with its corres- 
ponding slice number, and its entry in the SAT. 
For example, the DISKDDR is slice number 22 with an 
entry in SAT at offset 44 (@2C@) . 
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6. MCP STRUCTURE AND MEMORY ORGANISATION (CONT.) 
6.3 LOCKED AREA AND SLICES (CONT.) 

6.3.3 FUNCTION DEPENDENT ROUTINE (FDR) 



Part of the MCP code is divided into units each of 
which performs a specific set of f\anctions. The code 
for each unit is accessed through a slice. Examples of 
function dependent routines are the indexed file 
communicate handler (slice 31) , the open/close communicate 
handler (slice 17) , and the warmstart slice (slice 18) . 
In addition to these slices for accessing MCP function- 
dependent code, there are slices which hold buffers, for 
example: the data comm message buffers (slice 34). 



6.3.4 INTERPRETER CONTROL BLOCK (ICB) 

The code for an interpreter is also accessed through 

the slice mechanism. An interpreter slice, however, 

does not have its permanently allocated slice number 

and corresponding entry in the SAT, Interpreter slices 

are classifed as user slices and take a slice nvraiber 

from the pool of available entries at the top of the 

SAT. Unfortunately, this makes it difficult to distinguish 

program code slices from interpreter code slices when 

analysing dumps. The task structures, (see section 8) , 

allow these slices to be distinguished. 

It should be noted that if an interpreter is located 
in extended memory then it is allocated a permanent 
slice from the available pool anu tue Sj.ice is 
located directly following the BAILIFF and AVR slices 
in the memory map. If the interpreter is not loaded 
into extended memory at warmstart time, then its 
slice is created and released whenever programs which 
require the interpreter are loaded or terminated. In 
this case the interpreter slice is loaded after a TCB, 
and resides next to the Program Control Block. 



6.3.5 PROGRAM CONTROL BLOCK (PCB) 



Program code is accessed through the data segment 
table located within this locked slice. For COBOL and 
RPG programs the COP Table is also located within the 
task's PCB. PCB slices are user slices and take a slice 
number from the pool of available entries at the top of 
the SAT. 
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6. MCP STRUCTURE AND MEMORY ORGANIZATION (CONT.) 
6.3 LOCKED AREA AND SLICES (CONT.) 

6.3.6 TASK CONTROL BLOCK (TCB) 



The TCB is the slice which holds the control information 
for a task. Its contents are discussed in detail in 
section 8. 

Each TCB has a slice number which corresponds to the mix 
nimiber of its task. It addresses the corresponding PCB and 
ICE, and holds the CONTROL STACK which contains MCP 
restart information. The data segments for a program 
are accessed through the Data Segment Table held within 
the TCB. 

6.3.7 DATA SEGMENT TABLE (DST) 

A locked slice does not usually hold all of the code 
or data identified with the slice. Most slices 
contain a Data Segment Table (DST) . The DST is a 
table of segment descriptors (see table 6.4.1 SD MAP) 
giving the address of the associated code on disk, 
and also the memory address if the segment is present 
in main memory. 

The absolute memory address of the DST is held in bytes 
offset 14 and 15 (reversed) of the locked slice (see 
Tables 8.2.1 and 8.3.1). All items in the dump that 
locate other information in memory have now been 
described. 



6.3.8 EXAMPLES OF HOW TO LOCATE ITEMS 

Locate data segment 9 of a program running with mix = 4: 

a) Find the SAT (Fixed memory address) . 

b) The address of the TCB slice descriptor is at 
byte offset 2x4=8 and is byte reversed. 

c) The address of the DST is in. bytes 14 and 15 of 
this slice (reversed), (Tables 8.2.1 and 8.3.1). 

d) The segment descriptor is located at byte offset 
8 X 9 = 72 in the DST, and is 8 bytes long. 

e) The first byte of SD determines whether the segment 
is in memory, (Table 6.4.2) 

f) Bytes offset 1 and 2 (reversed) give the memory 
address of the segment, (Table 6.4.1). 
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MCP STRUCTURE AND MEMORY ORGANISATION (CONT.) 

6.3 LOCKED AREA AND SLICES (CONT.) 

6.3.8 EXAMPLES OF HOW TO LOCATE ITEMS (CONT.) 

Locate the COP Table of a program running with mix = 3 
(COBOL/RPG programs only) : 

a) Find the SAT (Fixed memory address) 

b) The address of the TCB slice descriptor is at 
byte offset 2x3=6 and is byte reversed. 

c) Byte offset 1 of the slice gives the index into 
the SAT for the PCB memory address (Table 6.3.1) . 

d) The COP Table is located in the PCB at the memory 
address held in bytes offset 10 and 11 (reversed) 
(Table 8.2.1) . 

6.4 OVERLAYABLE AREA AND SEGMENTS 

Above the locked memory area is the overlayable area. PTRX of 
MAP VMWA (Table 7.5.1) addresses the first byte and FTRZ the 
last byte of this area. To obtain an analysis of the structure 
of this area use the PRINT MEMORY. LINKS option of PMB80. 

The overlayable area contains code and data segments and may also 
contain available memory areas. All segments are accessed through 
the slice structure and Data Segment Tables as explained above. 
Available areas are also treated as segments and have a segment 
descriptor (with flags = @00(a) in the first eight bytes of the 
area. 

The segments in the overlayable area are linked together in 
the following manner (see figure 6.4.1), The first two bytes 
addressed by PTRX provide the memory address of the segment 
descriptor for the first segment in the overlayable area. 

This segment descriptor contains the absolute memory address 
and length of its segment. Immediately following this segment 
in memory, the next two bytes hold the memory address of the 
segment descriptor of the second segment in the overlayable area. 
This is repeated until the memory addressed by PTRZ is reached. 

If an available area is shorter than ten bytes in length (two for 
the memory link and eight for the segment descriptor) , then it is 
filled with binary zeros. A link with the first byte @00@ is 
invalid because this would point to ROM, and the virtual memory 
algorithms recognise that this byte is a filler, not a memory 
link . 
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6. MCP STRUCTURE AND MEMORY ORGANISATION (CONT.) 

6.5 PHT AREA 

The Peripheral Handling Table (PHT) area is located at the top 
of page zero of memory. The contents are analysed by the PRINT PHT 
option of PMB80, The area contains tables of information used by 
the Master Interrupt Processor (MIP) and DDR code. Each table is 
loaded into memory at warmstart time and remains at the same 
memory address throughout the session. The Tables are addressed 
by the field PHT. ADDR. TABLE of MAP PHDMP (Table 7.2.1). The 
contents of these tables are discussed in more detail in section 9. 

6.6 EXTENDED MEMORY 

J^x^.c^^^e^^ vPage 1; memory may contdin only a few selected 
items. To determine which items are in extended memory, 
use the PRINT MEMORY. MAP option of PMB80. 

Any or all of the interpreter segments, the index communicate 
handler segment, or the data comm message buffer segment may 
be held in this memory. If a slice is located in extended 
memory, then all segments of that slice are included in the 
extended memory. 

The segments (excluding data comm buffers) are loaded at 
warmstart time as specified by the SYSCONFIG file and subject 
to there being sufficient extended memory space. These segments 
then remain at their allocated memory locations for the entire 
session. 
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6.1.1 AREAS OF MEMORY 



@0000@ 
@1000@ 



(3.01) @32DB@ 



@6000@ 

to ' 

@E000^ 



@FCOO@ 
@FFFF@l 



ROM 



RESIDENT AREA 



LOCKED AREA 



OVERLAY ABLE AREA 



PHTAREA 



4KB 



13KB 



24KB 

to floating 
'60KB 



~ 63KB 
64KB 



@0000@ 



@3FFF@ 

or 
@7FFF@l 

or 
@BFFF@ 

or 
@FFFF@ 



EXTENDED MEMORY 
(PAGED 



16KB 

or 
32KB 

or 
48KB 

or 
64KB 



AREAS OF MEMORY 
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6.2.1 RESIDENT AREA LAYOUT 



@1000@ 

@100A@ 

@100E@ 

@1049@ 

@10AF@ 

@10BB@ 

@10BC@ 

@10BE@ 

@1114@ 

@1120@ 

@114E@ 

@117E@ 

@11DB@ 



@1316@ 
@131A@ 



@3279@ 
@32DB@ 



WM2GL0BAL 



MIP.ENTRY 



DEBUG.GLOBAL 



INTERGLBL 



DC. SPACES 



DC.STUFF 



DC.PATCH 



PHDMP 



VERSIONINFO 



DIAGCBUF 



VMWA 



GLBLM 



SCL BUFFER 



SCL lODESC 



DSK.RETRIES 



CT.INFO 



MIP 

1-0 Q HANDLER 



MCH 

DC AT 
I « bf^ki 

READ//WRITE RANDOM 
READ/WRITE STREAM 



}SET UP BY 
BOOTSTRAP 



>PHTAREA 



VM 



EPAR 



SAT 



-^OVERLAYABLE 
AREA 



-> LOCKED AREA 



LOCKED AREA 



RESIDENT AREA LAYOUT 
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A T 1 LOCKEn AREA TAYOUT 




OVERLAYABLE 
AREA 



LOCKED AREA LAYOUT 
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6.4.1 OVERLAYABLE AREA LAYOUT 



PTRX of VMWA 




PTRZ of VMWA 




OVERLAYABLE AREA LAYOUT 
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6.5.1 



PHT AREA LAYOUT 



OVERLAYABLE AREA 



PHT.ADDR.TABLE 
of MAP PHDMP 




high address end 
of page 



KEB.INT.BUFF 



DSKPM 



DSKPM 



PHTXDK 



PHTH 



QHEAD 



PHTXPANSEP 



one for 
each 
disk 
drive 



disk 
PHT 



PHTH 



QHEAD 



PHTXKEB 



PHTH 



QHEAD 






serial printer 
PHT 



keyboard 
PHT 



PHT AREA LAYOUT 
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6.6.1 EXTENDED MEMORY LAYOUT 



DST 




@0000@ 



DST 




SAT 




AVAILABLE 



MEMORY 



EXTENDED MEMORY LAYOUT 
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lASLE o.i 


•i - LOChTIQNS 


IN liEHORY 


DESTROYED 


BY t 


^EHORY ADDRESSES 








aoooe - 


9100Ee 








810300 - 


8103Fe 








aio7oe - 


eio7Fe 








QBOOOe - 


625358 









LOCATIONS IN MEMORY DESTROYED BY BOOTSTRAP 
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TABLE 6 


.3.1 - SATM MAP (3.01) - SLICE ADDRESS TABLE 




OFF LEH 

SET GTH FIELD 


USE 


FORHAT 


- 


OSRCSN 


meaiory addresses of slice descriptors 


LABEL 


2 


BLFS« 


BAILIFF Task Control Block (TCB) addess 


AA BR 


9 U 


TSKISN 


addresses for aix numbers i-8 (TCBs) 




IB 6 


AVRb'N 


Automatic Voluae Recognition (AVR) TCB address 








and utility miK nuiabers iO-il TCB addresses 




2^ 2 


3USN 


SYS-SUPERUTL ((iiix=13) TCB address 




36 2 


HCSSH 


Hessage Control Systea (HCS Bix=i3) TCB address 




36 3 


NDLSN 


Network control progradi {fflix=14) TCB address 




30 3 


LDRS« 


prograai LOADER (fflix=15) TCB address 




33 3 


SNABS 


absolute aeaory address slot 








used for entry to global «CP code 


- 


3^ ? 


DKADPSLC 


- 


= 


II II 


OPCLSN 


OPEN-CLOSE-AVR code slice address 




36 3 


INITSN 


DARHSTART-INITIALISE code slice address 




38 3 


DISPSN 


DISPLAY-SPO code slice address 




40 3 


LPRSN 


LINE PRINTER DDR code slice address 




43 3 


CSTRSN 


CASSETTE DDR code slice address 




44 3 


DSKRSN 


DISK DDR code slice address 




46 3 


SEPRSN 


SENNEFFE (60 cps) serial printer DDR address 




48 3 


KEBRSN 


KEYBOARD DDR address 




50 3 


SCREENSN 


SELF SCAN(SS1 or SS3) and CRT DDR code slice address 




53 3 


ADCRSN 


ASYNC DATA COHM DDR code slice address 




54 3 


SDCRSN 


SYNC DATA COHH DDR code slice address 




56 3 


DCSLICE 


DATA COHH COHMUNICATE handling code slice address 




5B 3 


CONSN 


CONSOLE COHHUNICATE handling code slice address 




60 3 


PANRSN 


PANTIN (130 and ISOcps) serial printer DDR address 




6S 3 


INXSN 


INDEXED FILE COHHUNICATE handling code slice address 




//^- 9 


PTPPQW 


RFii TTMF ri nry nno <-«*»« ^i;.-^ -.aa^^^^ 




»• • a. 


>» > VI^Wll 


>M-t«h. 1 Alll- WWUUI^ VUI\ uuuc 3 1 1 UC auUi C33 




66 3 


ICMSRSN 


ICHD DDR code slice address 




68 3 


HESSSN 


DATA COHH HESSAOE BUFFER SPACE slice address 




70 3 


CONBUFSN 


CONSOLE FILE BUFFER (non SCL keyboard input) address 




73 3 


SCLBUFSN 


SCL (keyboard and ZIP) BUFFER slice address 




74 3 


DIA6SN 


TRACE DIAGNOSTICS HCP codeslice address 




76 3 


OCOH.SN 


OVERLAYABLE COHHUNICATE handling code slice address 




78 30 


FREESM 


two-byte address slots used as required for 








Rpograffl Control Block (PCB) prograa code slice addresses and 


- 






Interpreter Control Block (ICB) interpreter addresses 


- 






slices 39-48 


" 



SATM MAP - SLICE ADDRESS TABLE 
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TABLE 6.3.1 RS HAP (3.01) - SLICE DESCRIPTOR 



OFF LEH 

SET GTH FIELD 



- SD 

1 S»FL/:J 

1 1 SDUSRS 
1 1 SDPEO 



1 
2 

.3 
5 

7 
8 
8 
10 



2 SDADDR 

1 SDCFDI 

1 SDIEO 

2 SDLEN6 
2 SDDKAD 

SDTKSC 

1 SDUNIT 

- SDSE6SZ 

2 SDPLNK 

- SDSLCSZ 



USE 



Slice Descriptor FLAGs 

slice USER count (applies to Code Control Blocks) 

Progriffl Environaent Offset (applies only to TCBs) 

index in SAT of slice address of PCB of this task's PCB 

aeaopy address of segment 

applies only to single segment DDR slices 

Code File Directory Index (applies only to CCBs) 

index in the disk directory of the disk copy 

Interpreter Environment Offset (applies to TCBs) 

index in SAT of the associated Interpreter slice address 

LENGth (in bytes) of the disk copy of this slice 

DisK ADdress (TracK and SeCtor) of the disk copy 
II 

disk UNIT on which the disk copy resides 
Pink LINK - memory address of the next slice 



FORMAT 

LABEL 

TABLE 6.3.2 
NOTE I 
INDEX 

AA BR 

INDEX 

INDEX 

e BR 
B 8R 

TABLE 7.2.1 
LABEL 
AA BR 
NOTE 2 



cont . . . ./ 



RS MAP (3.01) -SLICE DESCRIPTOR 
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TABLE 6.3.1 RS «AP (3.01) - SLICE DESCRIPTOR (cont.) 



10 


2 


ccecsTB 


10 


S 


PEP 


18 


2 


ccecsTL 


1? 


2 


lEP 


14 


- 


CCBFA2 


14 


2 


DBIA 


16 


2 


DSTLIH 

CSBS 


IQ 


2 


CSPA 


90 


2 


CSLM 


se 


1 


TOID 


23 


2 


SNTHSK 


25 


3 


FCH 



(CCB) address of Code Segment Table Base 

<TCB) address of related PCB slice descriptor 

<CCB) address of Code Segment Table Limit 

(TCB) address of related ICB slice descriptor 

(CCB) start of Preset Area 2 

Data Segment TAbie address 

DST LIMit address 

Control Stack BaSe address 

Control Stack Pointer Address 

Control Stack LiMit address 

task-id of the originator of this task 

MASK for field SINTFLAG of map INTERGLBL 

Fetch Cofltmunicate Message as returned froai the MCP 



AA BR 
AA BR 
AA BR 
AA BR 
NOTE 3 
AA BR 
AA BR 
AA BR 
AA BR 
AA BR 

TABLE 7.6.? 
TABLE 7.1.1 
TABLE 8.4.? 



mU 1 If bit 4 (8103) of SDUSRS is set then 
the slice eay not be swapped out. 

NOTE 2 If a slice is swapped out only the first 10 bytes 
of the 'descriptor reiaain in «eaory 

M3TE 3 non MCP CCB slice descriptors 

ai'e 14 bytes long (up to CCBPA3) 

TCB slice descriptors are 33 bytes long 

afid extend into an S Interpreter Work Area (SIWA) 



RS MAP (3.01) - SLICE DESCRIPTOR (cont.) 
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TABLE 6.3.C SLICE DESRIFTQR FLAGS - FIELD SDFLhG OF HAP RS 
BITS MASK INTERPRETATIOH 



7 80 reserved 

6/5 60 SLICE STATUS 

4 10 reserved 

Zri OC SLICE TYPE 

i 02 HEIiQRY PAGE NUMBER for all segments associdfced Hifch this slice 

01 Ust entry in PINK LINK chaii 

SLICE status: 

malue interpretation 



40 ABSENT from aeioory (SUAPPED OUT? 
20 MAINTAINED and PRESENT in aeaory 
00 ABSENT 

SLICE TYPE: 

MALUE INTERPRETATION 



CC Task Control Block (TCB) 

0^ Code Control Block (CCB); DDR, FDR, PCB, or ICB 

00 single segeent slice 

TYPICAL SDFLAG VALUES: 

VALUE INTERPRETATION 



00 absent single segment slice 

20 Maintained single segment slice 

24 saintained CCB with segnents in page 

26 caintained CCB with segments in page 1 

2C flaiatained TCB 

44 swapped out CCB 

4C swapped out TCB 

40 last entry in PINK LINK chaii 



SLICE DESCRIPTOR FLAGS - FIELD SDFLAG OF MAP RS 
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TABLE 6.^.1 - SEGD MAP - SEGMENT DESCRIPTOR 

OFF LEN 

SET GTH FIELD USE FORHAT 



1 S6DFL SeGflient Descriptor FLags TABLE 6.4.2 

1 2 S6DSS Segssent Start address in sefflory AA BR 
3 8 SGDSL nuaifaer of bytes in the segaient B BR 
5 2 SGDDA Disic Address (zero relative sector) of the disic copy 6 BR 

7 1 SGDDU Disk Unit holding the disk copy TABLE 7.2.1 

8 - SZ.SEG.DESC - LABEL 



TABLE 6.4.2 - SEGMENT DESCRIPTOR FLAGS - FIELD SGDFL OF MAP SEGB 
BITS MASK INTERPRETATION 



7 80 1 = segment USED recently 

6 40 1 = segftent ABSENT from laemory (overlayed) 

5 20 1 = segaent OVERLAYABLE (not locked) 

4 10 reserved 

3 08 1 = segment fflay_ be updated (READ-WRITE) 

2 04 1 = segment is not for systea use 

1 02 reserved 

01 1 = segment has been updated since it was read into aeniory 

TYPICAL VALUES FOR MOST SIGNIFICANT DIGIT? 

MALUE INTERPRETATION 



A/ 2 OVERLAYABLE segment PRESENT in siemory 
8, LOCKED segment (will be located in slice) 
6, 4 ABSENT (overlayed) segaent 

TYPICAL VALUES FOR LEAST SIGNIFICANT DIGIT: 

MALUE INTERPRETATION 



D/ 9 segment UPDATED 
C,8,4 segaent NOT UPDATED 



SEGD MAP - SEGMENT DESCRIPTOR and 
SEGMENT DESCRIPTOR FLAGS - FIELD SGDFL OF MAP SEGD 
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SECTION 7 



GLOBAL MCP MftPS AND TABLES 

This section discusses the information held in the Global MCP 
maps and tables. These maps should be examined in detail if the 
preliminary analysis discussed in section four is insufficient. 

On each release of the MCP, these tables are located at a specific 
av^dress in memory. As the uffaet and format of each map may change 
between release levels, PMB80 handles this by having different 
reference files PMBM.nnnnn and PMBO.nnnnn (see section 3). 

The global maps are analysed by PMB80 using the PRINT GLOBAL option. 
Single maps may be selected for printing by the appropriate parameter, 
to the print command (GWA, DIAGNOSTICS, VMWA, ESCT or SCL) . 



7.1 MCP - INTERPRETER INTERFACE 

The interpreter global work area (Table 7.1.1) holds the memory 
addresses of various global MCP routines. It also holds the 
first link into the memory organisation through SATLINK. A 

^-^„ ^^ Lu^^y. i,iiu.>_ <_iic:oc j-iciusj iiuxu vdxiu vaxues. 

For example, the Global MCP routines lie below the locked slice 
area between @1000@ and @4000(a, so the addresses of the global 
routines should be in this r^ange 

Another interesting field is TOTSICT. This is used in thrashing 
detection which is discussed in section 7.5.3. 



7.2 PERIPHERAL INTERRUPT HANDLING 

The peripheral handling dump area (PHDMP MAP Table 7.2.1) 
is used when the MCP is handling hardware interrupts, and 
when printing trace diagnostics. 

When a hard interrupt is received from an I-O channel, the ROM 
code causes entry to the Master Interrupt Processor (MIP) . 
This global MCP code stores the contents of the processor 
registers in PHDMP, and performs basic interrupt handling. 
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GLOBAL MCP MAPS AND TABLES (CONT . ) 

7.2 PERIPHERAL INTERRUPT HANDLING (CONT.) 

If the General Trace (GT) facility is switched on 
(see section 5) the processor registers are stored 
in PHDMP each time a trace point is encountered. If 
the system fails and issues a diagnostic on PK-lights 
17-24 (see section 5) the processor registers are also 
stored in PHDMP. 

Thus, the register dump fields of PHDMP contain the contents 
of the processor registers, either at the last I-O interrupt 
or the last diagnostic trace point. The latter case can 
be distinguished since PHDMPAD will equal the last one byte 
diagnostic in DIAGCIRC (Table 7.4.1). 

In either case, the contents of these dump areas usually give 
the most accurate information on which function the MCP was 
performing before the dtomp was taken. The interpretation of 
the registers is explained in section 5.1. 

The remaining fields of PHDMP are used by the MIP in 
handling 1-0 interrupts. Ihe field INTMASK gives the 1-0 
channels on which interrupts may be processed. The field 
INT. SCAN. TABLE provides the order in which interrupts should 
be processed. The field ISCT gives the channel which was 
last serviced; this field points to the PHT associated with 
that channel. 

7.3 KEYBOARD VERSION AND SPO TYPE 

The VERSIONINFO MAP (Table 7.3.1) indicates which translation 
table the MCP is using for printing characters. 

If wrong characters are being printed (£,^, $, etc.) this 

field should be checked and an engineer should be asked to 

give advice about correct installation of the machine backplane, 

7.4 DIAGNOSTIC INFORMATION 

As its name suggests, the DIAGCBUF MAP (Table 7.4.1) 
holds information specifically aimed at assisting problem 
diagnosis. It consists of three parts. The circular 
buffer of one byte diagnostics (DIAGCIRC) indicates what 
the MCP has been doing; that is, which of its global and 
slice code has been running. The register save areas give 
the task which is running and which microcode this task 
is using. 

The light switch indicates whether the keyboard was enabled 
at the time that the dump was taken. 

The PRINT DIAGNOSTICS option of PMB80 causes this map to 
be printed. 
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7. GLOBAL MCP MAPS AND TABLES (CONT. ) 

7.4 DIAGNOSTIC TMFm^MATTnM (cCiN'v.) 

7.4.1 ONE BYTE DIAGNOSTICS 



Trace diagnostics are discussed in section 5. Each 
time a trace point is encountered, the one-byte trace 
diagnostic is inserted in DIAGCBUF. This is done 
whether or not the MCP trace function has been switched 
on using the GT command. 

Field DIAGNINDEX of DIAGCBUF is the byte offset (zero 
relative) of the position of the next entry to be made 
in DIAGCIRC. With the entries in DIAGCIRC and reference 
to tables 5.3.1 to 5.3.11, it is usually possible to 

dPl-PTTm' TIP Wha-t- -t-bo MPD T.Tao /^^-ir-,^ -i rr,To,^/q-; ^-l-^n -T Tr^^-C^^ 

the dump was taken. 

No entries are made in DIAGCIRC when peripheral interrupts 
occur. This should always be remembered, and reference 
made to the PHDMP map to determine when the last interrupt 
occurred (see section 7.2) 



7.4.2 TOP OF CONTROL STACK 

The switching of control between tasks is performed 
by the EPAR (section 7.6.1). 'When EPAR exits and 
control is passed to a task, a diagnostic with value 
(aEE@ is entered in DIAGCIRC and the registers XY, L 

m-irl .T a V-£i CJa-YTQ/^ n n VVCAT7T? TOAT7"C -* « J TCTXTTTP TTfU ^ 

'-*■"'-* w >-4.j- «— u*-* V >.— \_4. j_ij. xi. J. t^jn V 1^ f XJ^dV±J CIIIU. UO.i-lVJ-:i» J-lltS 

contents of these registers at this time indicates 
which task gained control and which microcode was 
entered from EPAR. 

XYSAVE holds a copy of the top four bytes of the control 
stack of the task which was entered, (see table 7.4.2), 
and indicates in which microcode segment and at what 
offset the entry occurred. LSAVE holds the memory 
address (byte reversed) of the task slice descriptor. 
JSAVE holds the memory address (byte reversed) of the 
microcode segment to be executed. 

Only microcode may execute on the B80 processor; 
therefore all tasks except microcoded tasks need an 
ir.terpreter to be executed. Even microcoded tasks 
make heavy use of the MCP routines for peripheral and 
file handling. Thus it is very rare to find the entry 
code in XYSAVE referring to a task slice. The entry 
code usually refers to one of the following (refer 
to Table 7.4,2) : 
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GLOBAL vrp MAPS AND TABLES (CONT.) 
7.4 DIAGNOSTIC INFORMATION (CONT.) 

7.4.2 TOP OF CONTROL STACK (CONT.) 



INTERPRETER 



It is very unusual for problems 
to be encountered in an interpreter. 
The problem is likely to be related 
to a hardware interrupt. 



DDR 



MCP FUNCTION 



Many program communicates require 
input-output operations. These will 
be performed by an MCP DDR slice. 

Some program communicates require the 
execution of a Function Dependent 
Routine of the MCP. For example, 
file open and close, index file commu- 
nicates, console file communicates. 

Global MCP routines are entered at an 
absolute address. These addresses are 
stored in the INTERGLBL map (see table 
7.1.1, and section 7.1). 

BAILIFF (slice O) - a microcoded MCP task, see Section7.6.3 
SCL/LOADER (slice 15) - a microcoded MCP task, see Section 7.7. 



ABSOLUTE ADDRESS 



NOTE: 



Slice n\ambers in XYSAVE are twice the value expected. 
Tney proviae an inciBX xntu ortj. wnx(.;ii naa entxj.eij^ i_av^ i^j ^v,- 
long. For example, if XYSAVE has a value @12220000@, then 
the last code entered was slice 17 (=(a22@/2) , segment 18 
offset O, a segment of the MCP OPEN-CLOSE slice. 



7.5 VIRTUAL MEMORY SUBSYSTEM 

All movement of segments in and out of memory is the responsibility 
of the Virtual Memory (VM) subsystem. The VMWA (Table 7.5.1) 
is its work area. 



The work area contains memory addresses, lengths, an 
I-O descriptor for loading and unloading segments, and 
a "GETSEG" counter. 
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GLOBAL MCP MAPS AND TABLE S (CONT. ) 
'•5 VIRTUAL MiiMOKY oUtiSYSTEM (CONT.) 
7.5.1 MEMORY LINKS 



Without refernce to the MCP listing it is difficult 
to be certain of errors in the VM pointers. If a 
virtual memory operation is in process, the pointers 
may be in a transient state and be marked on the dump 
as "illegal". (The PRINT MEMORY. LINKS option of PMB80 
may produce spurious errors on such a occasion) . 

If a memory link becomes overwritten by some other 
part of the MCP, then the system may continue to run 
satisfactorily until the VM subsystem encounters the 

VM routine to fail due to a fault in another part of 
the system. A dump showing a fault in the memory 
j-inks may not give the solution to a problem but rather 
the symptoms of a completely independent fault. 



7.5.2 VIRTUAL MEMORY I-O 

The virtual memory 1-0 has the standard 1-0 descriptor 
format (see table 9.3.3). The most important field is 
the flags lODFL. 

Since, in a virtual memory system, disk is an extension 
of main memory, a disk "parity error" has very, serious 
implications. If the B80 MCP is unable to access any 

of its ViT-tnal momriT^? on rli aV -(-Vki^i-i Qvei^iTf--i ^r^ ■! ■-. v-.->i-i-^^ 

and a "DF" diagnostic is displayed. The virtual memory 
1-0 descriptor contains further information about the 
failure. The flags define the nature of the error (see 
table 9.3.4), the disk unit and address fields locate 
the area of failure. 

7.5.3 THRASHING DETECTION 

The virtual memory subsystem is responsible for 
thrashing detection. It uses the field GETCNTR, and the 
field TOTSICT of map INTERGLBL (table 7.1.1). 
GETCNTR is set to @100@ and decremented by one each time a 
segment is read from disk into memory. At the same time, 
TOTSICT is set to zero and incremented by one for each 
S-OP processed by an interpreter. GETCNTR provides a 
measure of the "wasted" work and TOTSICT measures the 
"useful" work. If the ratio (256-GETCNTR) : TOTSICT 
becomes greater than 1:100, then the MCP takes action 
to reduce thrashing. As the fields are periodically reset, 
no useful information can be derived if GETCNTR is close 
to (aiooia and TOTSICT is close to 0. 
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7. GLOBAL MCP MAPS AND TABLES (CONT.) 



7.6 SYSTEM CONTROL 

The MCP has three resources to manage; the processor, the 
MCP routines used by tasks, and the memory. The processor and 
MCP functions are allocated by the Execution Priority Assignment 
Routine (EPAR) , the task control subsection. The memory is 
allocated by the Bailiff, task O. 

The global MCP map GLBLM (Table 7.6.1) is the work area used 
by these sections of the MCP to control the allocation of these 
resources. The PRINT GLBLM option of PMB80 prints the contents 
of this map. The PRINT MIX option provides an analysis of some 
of the more useful fields of this map. 



7.6.1 PROCESSOR ALLOCATION - EPAR 

The EPAR manages the control of the processor by a 
system of "independent runners". These independent runners 
are tasks, each having a task-id and a corresponding 
mix number between O and 15 (see table 7.6.2). 

At any time, only one of these tasks is the current 
task and has control of the processor. 

Each task has an entry in the Execution Scan Table 
(ESCT) . The field EICT of map GLBLM points to the 
entry in ESCT for the CURRENT task. This byte, also 
called the task-id is displayed on the keyboard 
D-lights when control is passed to the task. 

Section 7.4.2 describes how to determine the function 
that the task is currently performing. 

The status of all the tasks in the system is stored 
in the Wait Key Table (WAKT) . Each entry in the ESCT 
has a one byte entry in the WAKT in the corresponding 
position. The order in which the task-ids occur in the 
ESCT and WAKT reflects the relative priorities of the tasks. 

The highest priority tasks occur first. The first six 
tasks in the table have specific functions and always occur 
first, followed by "user" tasks. 

The value of the entry in the WAKT indicates whether the 
task is runnable or waiting, plus the cause of waiting 
if applicable (see Table 7.6.3). 
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GLOBAL MCP MAPS AND TABLES (CONT.) 

7.6 SYSTEM CONTROL (CONT.) 

7.6.2 MCP FUNCTION CONTROL - LOCKS 

Some MCP routines may not be used by two tasks simultaneously. 
Each of these routines has a lock. These locks reside in 
the GLBLM map (table 7.6.1) . If a task is using one of these 
routines (for example: opening a file, or displaying a message 

set to the task~id. Sucn a xOck and lus corre3ponv_ij.ng 

MCP routine may not then be used by another task, which will 

have to wait. 

There may exist problems with the use of locks 
which could cause either a program or the complete 
system to hang. If there are two tasks holding 
different locks, and both of them are waiting for 
the lock which the other task holds, then a deadlock 
situation arises. Neither task can proceed. 



7.6.3 MEMORY ALLOCATION - BAILIFF 

The Bailiff (task O) controls the allocation of memory 
to tasks. If there is sufficient memory for all tasks 
in the mix, then the virtual memory subsystem will 
be overlaying segments in the overlayable area as 
required. If however, there is a shortage of memory, 
then thrashing will be detected and the Bailiff will 
come into operation. 

The Bailiff swaps slices in and out of memory. Swapping 
should not be confused with the segment overlaying operation 
performed by the virtual memory subsystem. Swapping is 
an operation performed on a locked slice. When a slice 
is swapped out, the entire locked slice (excluding the 
first ten bytes of the slice descriptor) is written out 
to disk and the other contents of the locked slice area 
are moved down in memory. In this way, more overlayable 
memory becomes available. 

Slices may volunteer for eviction by having no users, 
or being long waited, or they may be conscripted as 
required. 

Volunteers will only be swapped out when either enough 
volunteers exist to make it worthwhile (field SWAPCNT 
of map GLBLM is small enough) , or thrashing has been 
detected. If thrashing is detected and no volunteers 
exist, then a slice (usually a TCB) will be conscripted. 
If a task (TCB) is swapped out then it is no longer 
rxmnable. The task will be restored when more memory 
becomes available. 
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GLOBAL MCP MAPS AND TABLES (CONT. ) 
7.6 SYSTEM CONTROL (CONT.) 

7.6.3 MEMORY ALLOCATION - BAILIFF (CONT.) 



If a program is written which has very large segments 
(either data or code) then it is possible for thrashing 
to be detected when this is the only program running. 

In this case, the task will be evicted and never restored 
since no more memory becomes available . The operator 
must intervene with a GO command. 

The work areas used by the Bailiff to make decisions 
on swapping can be found in the GLBLM map (table 7.6.1) 
with further explanation in table 7.6.4. 



7.7 SCL INTERPRETER AND LOADER 

Task number 15 is reserved for the MCP slice which interprets 
the System Control Language (SCL) commands, and loads programs. 
When this task is running, the D-lights D4, D5, D6, D7 will all 
be on. 

The SCLBUFFER map (Table 7.7.1) holds the last SCL input (either 
from the keyboard or from a ZIP) and is terminated by elFia. 
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TABLE 7.1.1 - INTERGLBL HAP (3.01) - INTERPRETER WORK AREA 

USE 

teiory jiddress of global HCP routine 
II 

pointer to the Slice Address Table (SAT) 
total count of S-Instructions executed since 

field 6ETNTR of «ap VHUA was last initialised 

used for THRASHING detection 
duip of the K register 
5-INTerpreter flag/ the interpreter will 

release control and the HCP will SCANHIX 

when it is non-zero 

W «ll«i Wbtf i Ulf VUUfI b 3 I II UC Ui ailUli UU I 11 bCi }JI CtiCi 

GO to Master Coneunicate Handler (MCH) 
when non-zero 
leiory address of giobai HCP routine 

n 
II 
II 

Julian day (first three characters) 

Year 

Honth 

Day 

DAY Of the Ueek 

TIHE inforiation 

H 
II 

non-zero if Real Tiae Clock EXISTs 



GFf LEH 


SET GTH FIELD 


3 


60SCANMIX 


3 3 


60FINDC0D 


6 2 


SATLINK 


8 4 


TOTSICT 


19 2 


KDUHP 


14 2 


SIMTFLAG 


16 2 


SICOUNT 


18 1 


GOHCH 


19 2 


lAHCH 


21 3 


GOYIELD 


24 3 


G06ETSEG 


27 3 


GOPUTSEG 


30 4 


DATEJ 


34 2 


DATEY 


36 2 


DATEH 


58 2 


DATED 


40 3 


DAYOU 


43 1 


GOODTIHE 


44 3 


TIME 


47 10 


MIDNITE 


57 1 


RTCEXIST 


cont. 


..../ 



FORMAT 

AA BR 

■ 

AA BR 
B BR 



AA BR 



ASCII 
ASCII 
ASCII 
ASCII 



INTERGLBL MAP (3.01) - INTERPRETER WORK AREA (cont.) 
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TABLE 7.1.1 - INTERGLBL MAP (3.01) - INTERPRETER WORK AREA (cont.) 

5B 6 VERSION aark, release/ and patch level ASCII 

of last HCP cQipilation (PHesO files use this id) 

version of this patched HCP ASCII 

•eiory address of global HCP routine AA BR 



iA 


(> 


ACTUAL.VERSION 


70 


3 


60UNUT0NE 


73 


3 


GOYIELDR 


76 


3 


GOPUTSLCR 


79 


2 


GOGETSLC 


81 


3 


GOUNUTl 


8^ 


3 


60STK.J 


87 


3 


60UNSTK.J 


90 


3 


GOHSPRINTSTKR 


93 


3 


GOHSPRINTSTACK 


96 


3 


GOMSPRINTR 


99 


3 


60HSPRINT 



INTERGLBL MAP (3.01) - INTERPRETER WORK AREA 
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TABLE 7.2A - PHDHP HAP (3.01) - PERIPHERAL HANDLING DUMP AREA 



GFf LEN 




SET 6TH FIELD 


USE 


1 


PHDMPRQ 


I-O channel last serviced 


1 2 


PHDMPEX 


EXit address store 


3 8 


PHDMPST 


top of control STack/ held in 


ii n 


PHDHPXY 


XY processor register dusip area 


11 1 


PHDMPAD 


AD •* 


12 i 


PHDMPfiO 


BO " 


13 1 


PHDMPBF 


reaap of 


II II 


PHDMPFL 


FL processor register duap area 


1^ 1 


PHD«PB1 


Bl " 


15 2 


PHDi1PB32 


832 " 


17 2 


PHDMPJ 


J " 


19 2 


PHD«PK 


K " 


21 2 


PHDHPL 


L " 


S3 2 


PHDMPHl 


Ml " 


25 2 


PHDIiPWR 


WR " 


29 2 


PHDDRRESETJ 


J duap area for DDR use 


II II 


PHDDRDilPHl 


MI " 


31 2 


PHDDRREENT 


DDR RE-ENTry address 


cont. 


• • • ■ / 





FORMAT 

TABLE 9.2.2 
kk BR 

TABLE 7.4.2 
TABLE 5.1.1 



AA BR 



PHDMP MAP (3.01) - PERIPHERAL HANDLING DUMP AREA 
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TABLE 7.2.1 - PHDMP MAP (3.01) - PERIPHERAL HANDLING DUMP AREA (cont.) 



33 




QTC 


3^ 




8TS 


35 




QPRODB 


39 




QPRODG 


43 




lOX.SOFT.REQ 


44 




SOFT. REQUEST 


45 




SOFT. INT. MASK 


4^ 




SOFT.REQ.CH 


47 




INT.MASK.DUMP 


48 




INT.MASK.VM 


49 




INT.MASK.DC 


50 




INTHASK 


II 


II 


INT.MASK 


51 


8 


INT.SCAN.TABLE 


59 


8 


DISK.UNIT.TA8LE 


67 


8 


PHT.ADDR. TABLE 


83 


8 


ISCT 


85 


1 


DISK.RAW.FLA5 



Current Queue polled 

first Queue potted 

Q-Poll exit on failure (address and offset) 

Q-Poll exit on success (address and offset) 

channel enpander soft interrupt flag 

bit set indicates soft request to enter DDR 

bit set indicates soft interrupt 

by de-selected device 
ctiannel address of soft request 
INTerrupt MASK DUMP area (data coma) 
INTerrupt MASK excluding aixed channel expander 
INTerrupt MASK including nixed channel expander 
bit set indicates allow interrupt 
reaap of above 
channel adresses 

in descending order of priority 
disk unit nuobers in the above order 
PHT addresses in the above order 
set to address of current PHT on interrupt 
Read After Urite flag 



NOTE 1 

■ 

AA BR/RA BR 



TABLE 9.2.2 
TABLE 9.2.2 



NOTE 2 
AA BR 
AA BR 



NOTE 1 



an I-O queue head is six bytes longr and so 
valid queue "numbers" are eOOS 8069 8008 etc. 



NOTE 



Non disk channels have value SFF3. 

Each disk channel accomodates 2 units/ and so 

these unit numbers are 8000 0028 etc. 



PHDMP MAP (.301) - PERIPHERAL HANDLING DUMP AREA (cont.) 
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TABLE 7.2.2 - DEVICE MNEMONICS IN DESCENDING ORDER OF PRIORITY 
CODE DEVICE 



SDC 


sync ddtd com 


(Si)C 


dsync ddU cost 


CT 


cassette 


DK 


cartridge disk 


DF 


201-1 fixed disk 


EH 


Burroughs super mini disk 


DI 


industry compatible lini disk 


LP 


line printer 


SP 


serial printer 


KB 


keyboard 


S5 


self scan 


RT 


real tiise clock 



DEVICE MNEMONICS IN DESCENDING ORDER OF PRIORITY 
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IftBLt 7.iA - VIRSIOHMQ MAP (3.01) - KEYBOARD AND SPO INFO 

OFF LEN 

SET GTH FIELD USE FORMAT 



1 KBVERSION KeyBoird VERSION (1=US 2=UK 3=FRANCE etc.) BINARY 

1 1 VERSI0NFLA6 for 64-chdracter set, 2 for 96-char4cter set 

2 2 DISP.LINE. LENGTH display line length B BR 

4 1 DISP.PAGE. HEIGHT display page height (0 for printer) BINARY 

5 1 DISP.DVCK display device kind TABLE 8.5.2 

6 2 DISP.PHT aemory address of DISPlay PHT AA BR 

8 1 DISP.QHDO Display Queue HeaD Offset INDEX 

9 1 DISP.DDR.5N DISPlay DDR SI ice Nueber ( index la SAT) INDEX 

10 2 HSEXIT nessdge printer routine exit inforiation 



VERSIONINFO MAP (3.01) - KEYBOARD AND SPO INFO 
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TABLE 7.4.1 - DIAGCBUF HAP (3.01) - GLOBAL DIAGNOSTIC INFO 



USE 



index of next one byte entry in DIAGCIRC 
circular buffer of one-byte DIAGMOSTICS 

top of control stack on exit from EPAR 
pointer to base of SLICE or CO&E SE6HENT 
pointer to base of Task Control Block (TCB) 
fiFFe indicates that the console lights 
are available for diagnostic information 
i.e. the keyboard is not enabled 



CFF LEN 




SET 6TH FIELD 





1 


DIAGINDEX 


1 


3? 


DIAGCIRC 


33 


- 


DIAGCEND 


33 


8 


XYSAVE 


41 


2 


JSAME 


A3 


2 


LSAVE 


435 1 


LI6HTSM 



FORHAT 

INDEX 

TABLE 5.8.= 
LABEL 

TABLE 7.4.? 
AA BR 

AA ea 



TABLE 7.4.2 - TOP FOUR BYTES OF CONTROL STACK (RESTART ADDRESS) 

RESULTING BRANCH 



ENTRY CODE SLICE or SEGMENT 


OFFSET 


ONE BYTE 


ONE BYTE 


TWO BYTES REVERSED 


>=e8oe 


SEGMENT NUMBER 


SEGMENT OFFSET 


=€3F8 


08200) INDEX IN SAT 


SEGMENT OFFSET 


=€3F8 


(=6206) 


ABSOLUTE ADDRESS 


<:=e3Ee ) 


00209) INDEX IN SAT 


SEGMENT OFFSET 


SE5HENT ) 


(81E0-0O2@) TCB INDEX 


SEGMENT OFFSET 


MJHBER ) 


(=0000) BAILIFF 


SEGMENT OFFSET 



TO INTERPRETER SEGMENT 
TO SINGLE SEGMENT SLICE 
TO GLOBAL MCP CODE 
TO MCP SLICE SEGMENT 
TO TASK SEGMENT 
TO BAILIFF SEGMENT 



DIAGCBUF MAP (3.01) - GLOBAL DIAGNOSTIC INFO and 
TOP FOUR BYTES OF CONTROL STACK (RESTART ADDRESS) 
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TABLE 7. 


5.1 - Vftl« 


OFF LEN 




SET GTH FIELD 


4 


- 


4 2 


VMSTK 


6 2 


VMVSD 


8 2 


VHVLN 


10 2 


VHSCN 


la 2 


VHLIM 


14 2 


VHLNK 


16 2 


WRSD 


IB 2 


VliRLN 


20 18 


VHIOD 


38 2 


PTRX 


40 2 


PTRY 


^ 2 


PTRZ 


44 2 


PTRA 


A6 2 


GETCNTR 



VftWA MAP (3.01) - VIkTuAL flthUKY WORK AREA 



USE FORMAT 

pseudo control stack for virtual aeaory restart 

CSPA froffl current task SIUA 

address of Victim Segment Descriptor 

Victifl segment LeNgth 

clear aeaiory SCaN pointer 

clear aemory scan LIMit 

aeaory LiNK of first victia segment 

address of Requesting Segment Descriptor 

first two bytes of I-O descriptor 

equals Requesting segment Leflgth 

Virtual Heatory 1-0 Descriptor (see MAP lODESC) 

start of OVERLAY ARENA 

virtual meaory work pointer 

end of overlay arena (5 bytes past last segaient) AA BR 
II ■ 

count of GETSEG operations B BR 



TABLE 7.4.2 


TABLE 6.3.1 


AA U 


AA BR 


AA BR 


AA 8R 


AA BR 


AA BR 


6 BR 


TABLE 9.3.3 


AA BR 


AA BR 



VMWA MAP (3.01) - VIRTUAL MEMORY WORK AREA 
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TABLE 7.6.1 - 6LBL« MAP (3.01) - EPAR AND BAILIFF 5L0BALS 

USE 



CFF LE« 

SET GTH FIELD 



2 

2 - 



1 
i 
1 
1 
1 
1 
11 



9 
3 
4 
5 
6 
7 
8 

19 - 

19 1 

20 15 

35 1 

36 1 

37 1 

38 1 

39 1 
AO 1 

41 1 

42 1 

43 1 

44 1 

45 1 

46 1 

47 2 
49 2 
51 1 



EICT 
ESCT 

BLFESCT 

AURESCT 

LDRESCT 

NDLESCT 

HCSESCT 

SUESCT 

FIRSTBC 

WAKT 

BLFUAKT 

AWWAKT 

VMLOCK 

OCLOCK 

0CL0CK2 

SLCLOCK 

MSLOCK 

LDRFLAG 

LDRLOOSE 

DSPFL6 

HLPFL6 

HLPFL6.AVR 

BADIO.LOCK 

BADIO.FLAGS 

BADIO.LKTH 

BADIO.ADDR 

BADIO.Uf^IT 



address of current ESCT entry 
Execution SCan Table 

task-ids in descending order of pi-iority 
BaiLiFf ESCT entry (fflix=0) 
Autofiiatic Voiuffle Recognition tasic {ffiix=9) 
LOADER-SCL tasl< {«iix=15) 
mi ESCT {ffliK=i4) 
HCS task {fliiK=13) 
Super-Utiltity task (eix=12) 
the rest starting with B-priority tasks 
HAit Key Table in the saae order as the ESCT 
BaiLiFf UAit Key 

AVR WAit Key followed by the rest 
Virtual Heoory LOCK 
Open-Close routine LOCK 
Open-Close LOCK 2 

SLiCe routine (loading and swapping) LOCK 
Message printer (SPO) LOCK 
LoaDeR-SCL FLAG, set by ZIP or keyboard input 

to the task-id 

DiSPlay FLaG (GFF0=display to be done) 

HeLP routine FLaG (@FFe=DDR swapped out) 

SFFS indicates run the AVR-OPEN-CLOSE help routine 

BAIiff Descriptor 10 inforaation 

used by the logging routine 



FORMAT 
AA BR 
TAl^LF 7.6.? 

9 

I 
K 
E 



TABLE 7.6.3 



MOTE 1 



TABLE 7.6.2 



52 20 BADIO.DESC 



cont. 



GLBLM MAP (3.01) - EPAR AND BAILIFF GLOBALS 
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TABLE 7.6.1 - 6LBL« MAP (3.01) - EPAR AND BAILIFF bLUBALS (cone; 



72 1 

73 1 

74 1 

75 1 

76 1 

77 1 

78 1 

79 1 



80 
81 



ee 1 

83 1 

e^f 1 

85 1 

86 2 

88 1 

89 1 

90 2 
92 1 



VOL. ID 

VOL 

EREADY 

EVICT 

BFLAG 

BIOHAT 

SUAPIN 

SWAPOUT 

SUAPCNT 

EVICTID 

CONSCRIPT 

RSTID 

L06FILEFIN 

ERRLOGOFF 

HBESCT 

SCLINIT 

XTNFL6 

XTNSIZE 

SUHIDE 

NOTE 1 



tisk-id of sole volunteer (eFFP=riOt out) 

VOLunteer bailiff flags 

there Exist READY-to-restorc tasks 

EVICT flags 

Bailiff flags 

Bailiff 10 HATured flag {O=not) 

task needs SUAPping IN (O=not) 

task ready to SUAP OUT exists (O=not) 

-(number of slices with zero users +1) 

ID of task selected for EVICTION 

id of task conscripted 

ID of task selected for ReSTore (swap in) 

LOG FILE Finished flag (O=not) 

eFF? = logging not yet switched on (at wariBstart) 

address of first class B task ESCT entry 

valid date entered (not=eFF)(uarfflstart only) 

eXTeNded aeaory FLaG (eFF9=none) 

eXTeNded aenory size (e0000e=64KB) 



Lock bytes equal 9009 when they are free; 
or equal the ESCT (task-id) byte 
of the task holding the* 



TABLE 7.6.2 
TABLE 7.6.4 



TABLE 7.6.? 



AA BR 



B BR 



GLBLM MAP (3. Oil) - EPAR AND BAILIFF GLOBALS (cont. ) 
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TABLE 7.6.9 - TASK-ID, TASK STATUS, MIX NUHBERS 






flELD ESCT OF «AP 6LBLH: 






BITS HASK INTERPRETATION 






7,h CO TASK STATUS 


5 20 PRIORITY FLAG (0=profflot8d priority) 






4-1 IE MIX NUMBER (shifted left one bit) 






01 EXCHANGEABLE FLAG (l=ei<chdngedble «ith 


adjacent 


tasks ;•< EPCT) 


TASK STATUS (logical AND of TASK-ID with 90Ce): 






MALUE INTERPRETATION 






80 LONG WAITED 






40 SHORT WAITED 






00 RUNNABLE 






mi NUMBERS (logical AND of TASK-ID with SIES): 






MALUE INTERPRETATION 






<X) MIX = 0, BAILIFF 






Oe-10 MIX = i to 8, USER TASKS 






12 MIX = 9, Automatic Uoludie Recognition (AVR) 






14-16 MIX = 10 and 11, UTILITIES 






IB MIX = 12, SYS-SUPERUTL 






lA MIX = 13, Message Control Systea (MCS) 






IC MIX = 14, NDL 






VE. MIX = 15, program LOADER and System Control 


Language 


(SCL) code 


Logical AND of field WAKT of nap 6LBLM with SIFS: 







TASK- ID, TASK STATUS, MIX NUMBERS 



20154(X) 



7-19 



TABLE 7.6.3 - WAIT KEY TABLE (UAKT) VALUES (Logical AND with (aiF(a) 
WH« INTERPRETATION 



IF RUf<NAELE <i.e. not waiting} 

IE 

ID FREE (corresponding ESCT task is not assigned) 

IC NDL waiting 

18 

lA HCS waiting on HCSQUEUE 

19 

IB 

17 waiting on AD comnand frois the operator 

16 waiting on NO DISK FILE 

15 waiting on FILE IN USE 

14 waiting on NO FILE 

13 waiting on DUPLICATE FILE 

12 waiting on NO USER DISK 

11 waiting on OPERATOR INPUT 

10 waiting on DEVICE NOT READY 

OF 

OE 

OD 

CC SYS-SUPERUTIL waiting on SUPER ACCEPT 

OB waiting on RESTORE by bail if 

Ol\ waiting on DISPLAY 

09 waiting on ECHO 

08 waiting on MESSAGE PRINTER (SPO) (field HSLOCK of map GLBLH) 

07 waiting on ZIP 

06 waiting on ACCEPT 

06 HALF DELAYED 

0^ waiting on SLICE routine I-O (field SLCLOCK of cap GLBLM) 

C3 waiting on PROGRAM LOADER (field LDRFLAG of ffmp GLBLH) 

Oe waiting on VIRTUAL MEMORY 1-0 (field VHLOCK of iap GLBLM) 

01 waiting on file OPEN or CLOSE (field OCLOCK of map GLBLM) 

00 waiting on SECONDARY file OPEN or CLOSE (field 0CL0CK2 of nap GLBLH) 



WAIT KEY TABLE (WAKT) VALUES 
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TABLE 7.6.4 VOL, EREADY, EVICT, BFLA6 
BAILIF FLAGS HELD IN HAP GLBLM: 

WL (are there any tasks VOLUNTEERING for EVICTION ?): 
BITS MASK INTERPRETATION 



7 80 VOLUNTEER NEWLY CREATEJ 

6 40 VOLUNTEER EXISTS 
5-0 3F always set 

VALUE INTERPRETATION 

2F NO VOLUNTEER to be swapped out exists 
7F A VOLUNTEER exists 
FF A NEH VOLUNTEER exists 

EREADY (are there any tasks READY to be RESTORED ?): 

BITS MASK INTERPRETATION 

7 80 there exists sore than one task READY TO RESTORE 
6 40 there EXISTS ONE task READY TO RESTORE 

5-0 3F always set 



MALUE INTERPRETATION 



3F there exists NO TASK which would be runnable if restored 

5F there exists ONE TASK " 

n there exists MORE THAN ONE TASK 



cont. 



VOL, EREADY^ EVICT, BFLAG 
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TABLE 7.6.4 VOL, EREADY, EVICT, BFLAG (cont.) 
EVICT (what shall we EVICT ?): 
BITS HASK INTERPRETATION 



7 80 EVICT CONSCRIPTS 

6 40 EVICT VOLUNTEERS 

5 20 FORCE EVICT 
4H> IF always set 

EFLAG (what Is the BAILIFF doing now ?): 

BITS HASK INTERPRETATION 

7 80 - 

6 40 there KAY BE ROOK to RESTORE a task 
5 20 EVICT DONE 

4 10 ANOTHER EVICT is NOT NEEDED 

3 08 - 

2 04 there is an EVICT IN PROGRESS 

1 02 there Is a RESTORE IN PROGRESS 

01 the TASK BEING RESTORED is FROM the READY QUEUE 



VOL, EREADY, EVICE, BFLAG (cont.) 
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TABLE 7.7.1 - SCL BUFFER (3.01) - KEYBOARD/ZIP IHPUT 

CFf LEN 

SET GTH FIELD USE FORMAT 

1 STARTOFF START of data OFFsefc INDEX 

1 1 ENDOFF E«» of data OFFsefc INDEX 

2 256 SCLBUF SCL (keybard or zip) input buffer ASCII 



SCL BUFFER (3.01) - KEYBOARD/ZIP INPUT 
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TABLE 7.8.1 - CT.INFO (3.01) - CONFIGURATION TABLE INFO 

OFF LEN 

SET 6TH FIELD USE FORMAT 

2 CT2N0MS 2 tiaes the nunber af disk drives on the systei B BR 
2 2 CTLENGTH length of the Configuration Table (CT) B BR 



CT.INFO (3.01) - CONFIGURATION TABLE INFO 
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SECTION 8 



8. TASK RUN STRUCTURES 

This section explains the organisation and content of the 
different task structures. If an investigation of global 
MCP tables and memory layout reveals no cause of a failure, 
analysis of the contents of the task structures should be 
made to determine what action the tasks have most recently 
been performing. 

As explained in section 7.6.1, the MCP maintains a set of 
tasks called "independent runners". Only one of these tasks 
will have control at a particular time. A task structure 
may be printed out using the PRINT TASK option of PMB80. 
The CURRENT parameter causes the task currently in control 
to be printed. 



8.1 TASK ORGANISATION IN MEMORY 

Tasks are accessed throut^h the slices numbered 0-15; 
the Task Control Blocks. Slice numbers 0, 9 and 15 
are reserved for the MCP slices BAILIFF, AVR and 
SCL/LOADER discussed in section 8.2. The other 
slices in this range accommodate "user" TCBs as 
required. The TCB slice number is the same as the 
task mix number. 

The MCP tasks are single slice tasks, and the slices 
contain both data and microcode segments. User tasks 
consist of three slices: a data slice (TCB), a program 
S-code slice (PCB) and an interpreter microcode slice 
(ICB) . An exception to this is SORTINTRINS which is 
a microcoded program and so does not need an interpreter. 

A TCB is set up when a program is executed on the B80. 

The code and interpreter slices (PCB, TCB) for this program 

are created only if these slices are not already in memory. 

Program s-code and interpreter microcode is re-entrant, 
and therefore may be used by more than one task. 
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8. TASK RUN STRUCTURES (CONT.) 

8.1 TASK ORGANISATION IN MEMORY (CONT.) 

The TCB slice descriptor holds the index in the Slice 
Address Table (SAT) of the program and interpreter 
slice addresses (fields SDPEO, SDIEO of Table 6.3.1 - 
RS MTiP) . These two links locate the slices in use by 
a task, and these slices in turn hold the Data Segment 
Tables (DSTs) . which locate all overlayable segments 
associated with the task. 

8.1.1 CONTENTS OF A TCB 

A TCB locked slice contains a slice descriptor ; 
an S-Interpreter Work Area (SIWA) ; a Control 
Stack; a Data Segment Table (DST) , and any 
locked segments including File Information Blocks. 

An interpreter needs a working storage area for 
each task which it is executing; this is the SIWA. 
The format of an SIWA depends on the interpreter, 
but always starts with an extension to the slice 
descriptor which provides the interface between 
the interpreter and the MCP, and holds the memory 
addresses of the items within the locked slice. 

The use of the control stack is dependent on the 
S-machine (refer to the CMS MCP Reference Manual 
for details of the S-languages) . The control stack 
is also used by the MCP to store return addresses, 
as explained in section 7.4.2 

The DST holds the segment descriptors of all segments 

fj--,-- --H — -3 .,-'4-1- 4-T^ -*^ 4--^^l, c-x,^ m-»K1^ C A 1 — 

Ucttct aS!bO>JXclL.t3U WJLUll Cll-l-O l_a.OJS.. UCC J.<iJ->-i.= >_; . -I . -1- 

SD MAP. 

Any data segments which are not overlayable are also 

located within the locked TCB slice. Examples of 

locked segments are File Information Blocks (FIBs) 

for all open files (see section 8.6). The Data Stack 

(data segment O) of MPLII programs is also a locked segment, 

8.1.2 CONTENTS OF A PCB 

A PCB locked slice contains a slice descriptor 

an optional preset area (CCBPA2) and a Data Segment 

Table. 

For COBOL and RPG programs, the COP table is treated 
as part of the S-code (it does not change at run time) . 
It is included in the PCB, following directly after 
the slice descriptor. 

The DST contains the segment descriptors of all segments 
of s-code for the program. 
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TASK RUN STRUCTURES (CONT.) 



8.2 SYSTEM TASKS 



The system tasks are permanently present in the B80 mix 
although they are not evident in the response to the MX 
command. Detailed information about the contents of these 
TCBs is not usually required. 



,2.1 BAILIFF TASK 

The Bailiff is task O. The function of this task is 
explained in section 7.6.3. Segment 6 of slice O is 
the TASK TABLE which contains the names of the tasks 
is the mix along with other information (see Tables 
8.2.1 and 8.2.2). This information is included in 
uiie anaxysis proviLici^ j^y tiie FRII'gT MIX optj.oii of 
PMB80. 



8.2.2 AVR TASK 

The Automatic Volume Recognition (AVR) task has 
mix number 9. The purpose of this task is to allow 
the AVR operation to run efficiently with other 
tasks. It is executed when peripherals (especially 
disks and cassettes) are brought on-line and made ready. 
The MCP AVR code resides in the OPENCLOSE slice (17) . 



8.2.3 SCL/LOADER TASK 

This MCP task has mix number 15. The TCB references 
a large number of segments including work areas, FIBs and FPBs 
for code files and virtual memory files, and micro-code 
segments for performing various functions. 



8.3 USER TASKS 



With the exception of SORTINTRINS all programs create a run 

structure including three slices (TCB, PCB and ICB) . The TCB 

contains the run time information of the program. It is usually 

necessary to understand the S-language involved to perform 

a detailed analysis of the TCB information. This is not, however, 

usually relevant to system dump analysis. The most relevant 

information is the exact function that the task was performing 

which might have caused the system failure. Consequently, 

only the general layout of the task structures is provided here. 
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TASK RUN STRUCTURES (CONT . ) 

8.3 USER TASKS (CONT.) 

8.3.1 COBOL AND RPG TASKS 



COBOL and RPG programs both use the same S-interpreter 
(COBOLINT) , consequently their tasks have identical 
run structures. 

Each file declared in a program has three segments in 
the task structure: one FPB (Table 8.5.1), one FIB 
(Table 8.6.1) and one segment to contain the record 
work area. 

A file with indexed organisation has a larger FIB 
which includes an IFIB (Table 8.7.1) All FIBs are 
located within the TCB locked slice. 

Working storage has segments of size set by the COBOL 
dollar option DSSIZE with the limitation that segments 
occur on 01 levels. 

Program S-code is segmented as specified by the COBOL 
SECTION statement. 

The COP table is located within the PCB locked slice 
between the slice descriptor and the Data Segment Table . 
It is called CCBPA2 on a memory dump. 



8.3,2 MPLII (BID TASKS 

MPLII programs and BIL programs (the CMS compilers) 

share the same interpreter (BILINTERP) . In MPL, all 

data that is not specifically declared within an overlayable 

segment resides in the Data Stack (data segment O) . This 

segment is loca.ted in the TCB locked slice of an M'L program. 

Each file declared has an FPB segment and an FIB segment 
in the task slice, the FIB being located within the locked 
TCB. 

The PCB (program code slice) contains only a slice 
descriptor and a Data Segment Table. 



8.4 COMMUNICATES AND FETCH VALUES 

If the execution of a particular task causes the system to 
fail, then the failure is more likely to have occurred while 
the MCP was performing a function related to the task, than 
while the task's normal S-code was being inteirpreted. 
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TASK RUN STRUCTURES (CONT. 



8.4 COMMUNICATES AND FETCH VALUES (CONT.) 

A task makes a request to the MCP via a "communicate" S-Instruction. 
The last communicate can be found in the SIWA located within 
the task's TCB (see fields CPA.VERB and CPA of COBOL. TCB MAP 
Table 8.3.1, and field CPA of MTCB MAP Table 8.3,2). The value 
of the communicate indicates the function that the MCP is 
probably performing (see Table 8.4.1). This often directs 
attention to a specific Device Dependent Routine or Function 
Dependent Routine. This may be a clue to the writing of a small 
test program to attempt to create a reproducible occurrence of 
the problem. 

when the MCP completes a communicate request, it returns control 
to the task and puts a value in the TCB called the "fetch value" 
or Fetch Communicate Message (field FCM or MAP RS - Table 6.3.1). 
The value of this field indicates the result of the operation 
(see Table 8.4.2) . 



8.5 FILE PARAMETER BLOCK (FPB) 

This data segment which is present in a program code file contains 
the initial values relating to a logical file. It contains 
sufficient information to enable a task to locate a physical 
file on a specific medium (see Table 8.5.1 - FPB MAP). The 
FPB in the code file can be changed with the MODIFY utility. 



8.6 FILE INFORMATION BLOCK (FIB) 

In addition to an FPB, a logical file has an FIB. If the file 
is closed, the information is small enough to reside in a 
special segment descriptor with a flags value of @48(a called a 
"vestigial FIB" (Table 8.6.2 VEST. FIB MAP). This descriptor 
resides in the DST of the TCB. When the logical file is opened, 

an FIB segment is created in the locked TCB slice and values 
inserted which reference the physical file. 

An FIB includes the file buffers with an I-O descriptor for each. 
When an 1-0 operation is to be performed on the file, one of 
these 1-0 descriptors is linked to a queue of descriptors called 
an 1-0 queue. Pointers to the queue are located in the PHT of 
the device involved (see Section 9) . The 1-0 descriptors should 
be checked for valid contents, since invalid 1-0 information 
(which may be a result of a hardware fault) is a frequent cause 
of system failures. 
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TASK RUN STRUCTURES (CONT. ) 

8.7 INDEXED FILE INFORMATION BLOCK (IFIB) 

A logical file with the CMS indexed organisation consists of 
two physical files, a key file and a data file. The FIB of 
files with indexed organisation contains an IFIB which itself 
holds two buffers and I-O descriptors to the key file (see 
Table 8.7.1, IFIB MAP). 
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8.3.1 USER TASK COMPONENTS IN MEMORY 



SAT 




TCB 



SLICE 
DESCRIPTOR 



/SIWA 



DST 



LOCKED 
SEGMENTS 



1.^ 



ICB 



SLICE 
DESCRIPTOR 



DST 



PCB 



SLICE 
DESCRIPTOR 



DST 



pointers 
to 

overlay able 
segments 

(disk 

and 

main 

memory 

copies) 






USER TASK COMPONENTS IN MEMORY 
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8.3.2 CCaOL/RPG TCB COMPONENTS 



FROM SAT 




SLICE DESCRIPTOR 



S-IIMTERPRETER 
WORK AREA 



CONTROL STACK 



DATA SEGMENT 
TABLE 



FIB 

lODESCRIPTOR 

BUFFER 
lODESCRIPTOR 

BUFFER 



FIB 



lODESCRIPTOR 
BUFFER 



->toPCB 



->to ICB 



for COBOL! NT 



->to 
-^overlayable 

data 
_^ segments 



COBOL/RPG TCB COMPONENTS 
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8.3.3 COBOL/RPG PCB COMPONENTS 



FROM SAT 



FROM 

TCB 

SIWA 




SLICE DESCRIPTOR 



COP TABLE 



DATA SEGMENT 
TABLE 



to 
-^overlayable 
S— code 
segments 



COBOL/RPG PCB COMPONENTS 
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8.3.4 MPLII (BID TCB COMPONENTS 




SLICE DESCRIPTOR 



S-INTERPRETER 
WORK AREA 



CONTROL STACK 



DATA SEGMENT 
TABLE 



DATA STACK 
(DATA SEGMENT 0) 



FIB 



lODESCRiPTOR 
BUFFER 



->to PCB 



->to ICB 



forBILINTERP 



->to 

overlayable 
-^data 



segments 



MPLII (BID TCB COMPONENTS 
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TABLE 8.1.1 - TASK TYPES 

TASK TYPE TCB PCB ICB EXAMPLES 

m:p task data + «-code bailiff, loader 

h-coce utility data h-code softtintrins 

S-CODE UTILITY DATA S-CODE M-CODE SYS-SUPERUTL, COPY 

UBEft TASK DATA S-CODE «-COfiE DCS, DOMAIN, TMCS 

M-CQDE = jsachiae aicrocode 

3-CODE = secondary code executed by one of the virtual eachines :- 
«-lII{fiIL>, COBOL/RPG, HDL. 



TASK TYPES 



2015400 gjj 



TABLE 8.2.1 - TASKTAB MAP (3.01 > - TASK TAHLE 



OfT LEH 




SET GTH 


FIELD 


- 


BTSTRT 


1 


enoT»'iL 


1 1 


enoiL'SER 


2 1 


BTHAXUSER 


3 1 


BTXSUTIL 


4 1 


BLAST ID 



USE 



TOTAL number of tisks in the siik 

Tulai nuffiber of USER tasks in the aix 

MAXiauj! nuiiiber of USER tasks ai lowed in the aix 

nufflber of UTILitites with a user task-id (siK-dO) 

Task-ID of the LAST user task loaded 



FORMAT 

LABEL 
BINARY 



TABLE 7.6.5 



TAELF 8.2.2 - TASK HAP (3.01) - TASK TABLE ENTRY 



OFF LEH 

SET STH FIELD 




7 

i7 

m 



7 

12 

3 

3 

1 



TPKIS 

TFLID 

TFCH 

TVMPTR 

TREST 

TENTRYSZ 



USE 



prograa pack- id 

prograffl file- id 

pseudo fetch casmunicafce aessage area (for ZIPs) 

zero relative sector address of the Virtual fteisory 



FORMAT 

ASCII 
ASCII 

TABLE 8.4.2 
6 BR 

LABEL 



TASKTAB MAP (3.01) - TASK TABLE and 
TASK MAP (3.01) - TASK TABLE ENTRY 
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TABLE 8.3.1 - COBOL. TCB (3.01) - COBOL/ftPb INTERPRETER SI«A 



a^r 


LEN 




SET 


GTH 


FIELD 





10 


- 


10 


d 


COPPTR 


12 


2 


ISEGPTR 


14 


2 


BSTPTR 


16 


2 


STKEASE 


18 


2 


STKPTR 


30 


2 


STKLIH 


29 


1 


TASK. ID 


23 


2 


SIKTHASK 


:>i 


3 


FETCKV 


a3 


1 


PSE6 


i^ 


2 


PfiISP 


31 


2 


PARTIAL.ST 


33 


3 


VERSION 


36 


1 


DUHP. MESSAGE 


3? 


- 


ZIP.AREA 


37 


- 


JOB. PACK 


37 


- 


KIX.fiUHeER 


37 


1 


ISE6 


38 


2 


PSEGPTR 


AO 


2 


P6E6BASE 


4? 


3 


COHH.MSG 


45 


1 


OVERFLOy 


46 


2 


LINE.CNT 


48 


2 


HALT. POINT 


50 


1 


CFA.VERB 


51 


2 


CPA 


S 


8 


MULTIPLICAND 


II 


II 


XY.REVERSE 


II 


II 


XY.SAVE 


61 


6 


SftVE.DESC 


67 


2 


ZERO.CALL 


II 


II 


DP.CALL 


<i<? 


2 


DP.CALL? 



USE 



Usfc slice descriptor 

address of FCB locked slice holding COP TABLE 

Address of interpreter locked slice 

address of Data Segmerit T-^tbie for this TCB slice 

address of first byte of the- COK'TROL STACK 

current pointer in the control stack 

end cf the control stack 

TASK-ID of father mOi if not zipped) 

aiask to S INTEL AG 

FETCH VALUE area (updated by HCH) 

Prograffi code SEGsent for BOJ 

Profras segaient DlSPIaceaierit for BOJ 

length of PARTIAL STack 

DS/DP MESSAGE numbsr 



current Interpreter SEGaient nuaiber 

Progran SEGisent table PTR 

current Prograa SEGiaent EASE address 

FETCH VALUE store area 

GVERFLOy s-register 

LINE COUNT s-register 

debug HALT line nusber 

Cofflisunicate Parameter Area VERB 

CPA object and first paraaieter byte 

used in «iultiply routine 

used in edit routines 

used in subscripting and indexing 

used In decoding s-op pafaineters 



FORMAT 

TABLE 6.3.1 
AA BR 
AA BR 



TABLE 7A.2 
TABLE 7.1.1 
TABLE 8.4.? 
BINARY 
B BR 
S BR 



BINARY 
AA BS 
AA U 

TABLE 8.4.? 
BINARY 
BINARY 
BINARY 
TABLE 8.4. 1 



cont. 



./ 



COBOL. TCB (3.01) - COBOL/RPG INTERPRETER SIWA .(cont.) 
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TA6Lf: 


8.3. 


1 - COBOL. TCe (3 


.01) - 


COeOL/RPG INTERPRETER SItIA (cont.) 




71 


1 


HOBIFICATION.OK 


- 






7d 


8 


COP.EXT 


used 


to store COP EXTensions 




W 


2 


EXT.PTR 


pointer to eKtensions 




83 


8 


SAVE.CPA 


SAVE 


cosisunicite P^r.^sieter Are^ 




II 


H 


HOBIFIER 


used for holding subscript or index (aodifier 




TO 


2 


SUE. FACTOR 


current subscript factor 




11 


II 


fiULTIFllEft 


used 


in aiultiply routine 




II 


II 


INDEX. COUNT 


number of indices 




98 


6 


ABS.SAVE 


used for holding the absolutised descripto 




98 


8 


XY.DUilP 


used 


for nuaber reversing 




11 


11 


SA'v'E.XY 


II 






104 


2 


REAL.ABS.RTN 


where 


to go if dbsolutise fails 




lOS 


8 


XY, STORE 


used 


in arithinetic operations 




II 


11 


OPKDa.SAVE 


II 






ti 


U 


CAT. LENGTH 


used 


in CONCATENATE 




11 


U 


REMAINDER 


used 


in DIVIDE 




II 


11 


«EG.DiyJSOft 


(1 






110 


6 


0PHD3.SAVF. 


used 


in EXAHINE 




t( 


ti 


CATZ.DISP 


used 


in CONCATENATE 




11? 


2 


OP«M.SAVE 


used 


in EXAHINE 




II 


11 


CAT.SEb 


used 


in CONCATENATE 




m 


2 


S.OP.ADE'RESS 


offset of current S-OP within code segaent 




116 


2 


DIVISOR 


used 


in DIVIDE 




II 


II 


SPACES.COUNT 


- 






" 


II 


SOURCE. COUNT 


used 


in arithmetic routines 




II 


II 


S0URCE.LEN6TH 


11 






lie 


2 


SOURCE. AKDR 


11 






180 


2 


BEST.LEN&TH 


II 






18? 


2 


DEST.AL'BR 


II 






18^ 


1 


DEST. FLAGS 


II 






II 


II 


FLAG. SAVE 


used 


in EDIT 




II 


II 


RESULT.S16N 


used 


in fiULTlPLY 




II 


II 


BIVISOR.SKiN 


used 


in DIVIflE 




II 


II 


CRPT.REHAIN8ER 


used 


in COHPARE REPEAT 




II 


II 


ZERO. SAVE 


- 






II 


11 


SIGN.M6IT 


- 






II 


II 


ZERO. «R. SAVE 


- 






1 cont . . 


.../ 












COBOL. TCB (3 


.01) 


- COBOL/RPG INTERPRETER SIWA (cont. 


T 



RA BR 
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TABLE 8.3.1 - COBOL.TCB (3,01) - COBOL/RPG INTERPRETER Sim (cont.) 

325 1 SAVE.SIGN 

126 i EDIT.HASK 

TESTB.SAVE 

" SETB.SAME 

ZERO.eO.SAVE - 

" " REH.SI6N used in DIVIDE 

127 1 DIV.TYPE 

128 1 fRSCL.aUOT 
" " fftSCL 

12? 1 FRSCL.RErt 

130 2 QUflT.LENGTH 

13? 2 QUOT.ADDR 

13'c 1 eUOT. FLAGS 

135 1 R!Vr> .LENGTH 

136 45 QUOTIENT 

RESULT. FIELD 

1.81 U DIVIDEND 

" " END.OF.RESULT - 

197 3? EDIT.SWTB 

©9 38 AEDIT.SyTB 

261 - EDIT. TABLE 

261 1 PLUS. ENTRY - /^gCII 

as? 1 NINUS.ENTRY - « 

263 1 6LANK.ENTRY 

aw 1 AST.ENTRY 

a45 1 POINT.ENTRY 

aS6 1 COHMA.ENTRY 

267 1 DOLLAR. ENTRY 

a^ 1 ZERO.ENTRY 



COBOL. TCB (3.01) - COBOL/RPG INTERPRETER SIWA (cont.) 
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IflBLE 8.3,2 - «TCB HAP - MPLII (BID IHTERPRETER WORK AREA 



LIT LEH 

SET 6TH FIELD 



USE fORHAT 





10 

12 

14 

16 

18 

20 

22 

a? 

23 
25 
2B 
31 
33 

y^ 

36 
36 
3? 
■■S3 
iO 
61 
6i 
iA 



10 

2 

2 

2 

2 

2 

2 

1 

2 

3 

3 

2 

1 

2 

2 

1 

1 

22 

i 

2 

1 
3 



ER.ADDR 
PSTA 
ISTA 
DSTA 

cse 

CSA 

CSL 

SIWA 

TASK. ID 

SINTftASK. 

FETCHV 

SSft 

P. STACK 

ISEG 

CfA.FTR 

CPA 

CFA.VB 

CPA.O&'J 

CPA.REST 

C2«fl.ERR 

CSEGB 

ERR. NO 

C0MH.MESSA6E 



task slice descriptor TABLE 6.3.1 

Progras Sagiaent Table Address - code DST AA BR 

Interpreter Segment Table Address AA BR 

Data Segesnt Table Address AA BR 

Control Stack Base Address AA BR 

Control Stack Address (current pointer) AA BR 

Control Stack Liait address AA BR 

LABEL 

TASK ID of the originator (fiSOQ if not ZIPped) TABLE 7.i.2 

nask to SINTFLA6 TABLE 7.1. t 

FETCH cofiiRunicate Value returned by MCH TABLE 8.4.2 

S-code Start Address (segaent + offset) S+(AA BR) 

Partial STACK length (user part of control stack) B BR 

Interpreter SEGasent number (=6009 on 3.01) SUBSCRIPT 

work pointer in CPA ^^ BR 

Cojiiiiiunicate Paraaetsr Area TABLE 6.4.1 
CPA VerB 
CPA OSJect (adverb) 

CGfifianicate s-o^ (e43e=C0fiME,9739=C0KH) 

current Code SEGaent Base address AA BR 

internal ERRror nuaber 

fetch COHHunicate MESSAGE TABLE 8.4.2 

updated by interpreter and accessed by FETCH. VALUE 



cont. 



MTCB MAP - MPLII (BIL) INTERPRETER WORK AREA 
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'lACLE 8.3.9 - HTCB M? - Hflll (BID INTERPRETER WORK M.^ (cont.) 

67 1 IU\ LexJcdl Level confcaining isost-Accessed daci BINARY 

iB 1 RLN nexi;-ffi03t-frequeri>;iy-dcce5sed-d5tj Isvei BINARY 

m 2 LBA DISPLAY value of LLN 

71 2 RBA DISPLAY value of RLN 

73 1 PSN current Progreiji Segisent Nmsber BINARY 

7^» 1 CPN Current Procedure Nua&er (within the segment) BINARY 

75 2 PCA Prografl! Current Address (offset within code segaenk) BINARY 

7^ 2 PRO current offset within PROcedurs BINARY 

79 1 «ODE eOOe = execution/ @018 = reaap or declaration 

SO 2 CARRY CARRY software register 

i2 2 NiiR Nufifaer of flessage Reference bytes used BINARY 

W^t i NLD Next Local Descriptor (nunsber within this procedure) " 

to 1 LVL current lexical LeVsL " 

Sd ? STd data STacIc Ease address (data segaenfc 0) AA BR 

e3 2 STL data STack Length BINARY 

90 3? DISPLAY 16« (16-bit) indexes in the data stack B BR 

li? 2 fiiDUftPAMR processor register store areas TABLE 5.1.1 

124 8 XYSTORE 

1.;^:? 4 BOSTGRE " « 

136 2 e3?S10RC 

136 2 SIASTGRE 

140 2 GETSEG.HI register inforaation for «CP 6ETSE6 operation 

6ETSEb.E38 

6ETSE6.fi? 

DATA.SE6.STATS - 

CODE. SEG. STATS - 

140 1 VSN Virtual Segment Nodiber for EOJ BINARY 

14). 2 HSPACE «axi(»u«i size of Hessage reference table 6 BR 



MTCB MAP - MPLII (BIL) INTERPRETER WORK AREA (cont. 
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Wbil 


ii,<*.'i ' 


t.umtiJftiCMTr. VERBS 


CLASS VERB 


BITS COriilL'NICATE <byta = verb, byte 1 = object) 


B 


00-OF 




FILE ASSIGNHE^T (object = FIB segasent nusber) 


B 


Oi 


- 


FILE OPE« 


6 


02 


- 


FILE CLOSE 


C 


10-aF 




FIELD ORIENTED I-O (object = scgaent nuisber) 


C 


« 


01 


ZIP 


C 


11 


02 


DISPLAY 


C 


■1 


04 


PAUSE 


C 


n 


08 


CONDITIONAL 


C 


20 


- 


ACCEPT 


D 


30-3F 




DATA COKHUNCATIONS 


E 


40 


- 


DATE-TIHE 


E 


K\ 


- 


TERMINATE 


E 


42 


- 


WAIT 


E 


43 


- 


SYSTEfi STATUS 


F 


70-7r 




HACHINE DEPENDENT (880) 


F 


70 


- 


YIELD 


F 


71 


- 


GETSE6 


F 


72 


- 


piJTSEG 


F 


73 


- 


PUTLP 


F 


74 


- 


SUSPEND 


A 


80-9F 




FILE TYPE 1-0 (object = FIB segment naaber) 


A 


II 


01 


CONDITIONAL COflfiUNICATE 


A 


60 


- 


TEST STATyS 


A 


82 


- 


READ (not CONSOLE) 


A 


84 


- 


WRITE (not CONSOLE) 


A 


U 


- 


REWRITE 


A 


88 


- 


DELETE 


A 


8A 


- 


STREAM CONTROL 


A 


8C 


- 


START 


A 


8E 


- 


OVERyRITE 


A 


?0 


- 


READ-WRITE 


A 


92 


- 


READ (CONSOLE) 


A 


94 


- 


WRITE (CONSOLE) 


A 


9i 


- 


GET 


A 


98 


- 


POT 


A 


9A 


' 


REDEFINE WORtfAREA 








COMMUNICATE VERBS 



8-18 



TABLE 8.4.2 - FETCH VALUES 


FILE HAND! 


IM5 COHHUJUCi'tTES 


<X) - - 


SUCCESSFUL 


10 - - 


QUEUE EHFTr or receive «ith K'Q DATA option 


a> - - 


FATAL ERROR occarrsd during coiSffiunicdte 


20 10 - 


Eh'B OF FILE encountered on sequential input 


ao 20 00 


mJAlW KEY 


30 20 10 


INVALID KEY - sequence error on output to indexed fiie 


30 20 20 


INVALID KEY - dupiicite key on indexed file 


20 20 iO 


INVALIC KEY - no such record exists 


20 20 40 


INVALID KEY - boundary violation (e.g. write past EOF) 


30 30 00 


PEF!.fiANLfiT ERROR 


SO 30 10 


FERHANENT ERROR - detected on read froai data file 


30 30 20 


PERHAMENT ERROR - detected on write to data file 


30 30 30 


PfRHAMFNT FRROR - detected on read fros ice" file 


■20 30 40 


FERHaNhfIT ERROR - detected on write to key'fila 


40 XX XX 


CONDITIOflAL FAILURE (bytes 1 and 2 = the CMS event number) 


W XX XX 


FATAL ERROR (bytes i and 2 = the CMS event nusbef ) 


RfSULT OF 


ZIP COHHUHICATE 


00 XX XX 


SUCCESSFUL (bytes 1 and 2 may contain a stop value) 


30 00 10 


program file not found 


30 00 20 


interpreter file not found 


20 00 30 


insufficient (liesory 


30 00 40 


no user disk for® virtual sieaory file 


20 00 50 


full fiix 


30 00 60 


user count error 


30 00 70 


duplicate pack (two packs with saaie id) 


30 00 80 


invalid load request 


30 00 90 


>1CS already present in sis 


20 CO AO 


disk error 


30 00 BO 


code file error 


30 00 CO 


illegal data cosiB load request 


30 00 DO 


program DS'ed (ZIP PAUSE only) 


30 00 n 


prograo DP'ed (ZIP PAUSE only) 


30 CO EO 


SUPER UTILITY busy (CH RM PD etc.) 


^0 XX XX 


COflDITIONAL FAILURE (bytes 1 and 2 = the CHS event number) 


80 XX XX 


FATAL ERROR (bytes 1 and 2 = the CfiS event number) 



FETCH VALUES (cont. ) 
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TABLt 8.4.? - FETCH VALUtS 

3JCCESSFUL CO«SOLE COMHUHCIATE RESULTS 

00 FO 00 reset 

00 08 00 set 

00 04 00 set if the C-KEY was depressed 

00 09 CO set if the «-KEY «is pressed 

00 01 00 reserved 

00 00 65-68 OCKI to OCKIIII respectively 

00 00 01-84 PKl to PK24 re:pect(veiy 



FETCH VALUES 
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lASLE 8.5. i - FPB HAP 


(3.01) - FILE PARAMETER BLOCK 




If f LEf 


! 






SET bTH FIELD 
1 FPBILNO 


INTERPRETATION 


FORMAT 
BINARY 


IffiplefflenUtion Level (currently=a) 


1 7 


FPEPKID 


PACK IB, VOLUME ID/MULTIFILE ID 


ASCII 


1 7 


FPeMFID 


tl 


U 


8 1? 


FPeFLID 


FILE ID 


ASCII 


a) 1 


- 


space (0309) 


ASCII 


a 3 


FPBRLNO 


REEL m (000-999 incU 


ASCII 


9^- i 


FPfiFLTP 


FILE TYPE 


TABLE 10.3.4 


25 3 


FPEHRCN 


Highest Record fedibsr written to file 


BINARY 


^3 i 


FPEDyCK 


DEVICE KIND 


TABLE 8,5..? 


?; 1 


FpeesTi 


I'iU Segsient Table Index of record workdrea 


BINARY 


.30 ? 


FPfiyKAO 


WorK Area Offset within above ssgsent 


BINARY 


32 9 


FPBRC3Z 


RECORD SIZE 


BINARY 


3=V 2 


FPE'BFSZ 


BUFFER (block) SIZE 


BINARY 


3S 3 


FPBHXSZ 


HaKifflUiS File Size (in records) 


BINARY 


3?; i 


FPBNOBF 


NuiBber Of Buffers 


BINARY 


40 i 


FPBFLAG 


FLA5S 


TABLE 8.5.3 


41 1 


FPBADCL 


coiHiTiunicate adverb for CLOSE 


TABLE 8.5,4 


48 3 


FPBABOP 


cQiTiiiiunicate adverb for open 


TABLE 8.5.5 


44 2 


FPeCYCL 


CYCLE nuiiiber 


ASCII 


4<S 2 


FP6GNN0 


GENERATION number 


BINARY 


4G 5 


FPeCRDT 


CREATION I'ATE (YfDDD) 


ASCII 


Si 5 


FFBLADT 


LAST ACCESS DATE (YYDDD) 


ASCII 


33 .? 


FPBSPBY 


SPARE BYTES in last stream record 


BINARY 


(f/) 3 


FPBSyFR 


SAVE FACTOR 


ASCII 


^3 7 


IFPB.tJFPID 


Indexed File Paraaeter Block Data File Pack ID 


A.SCII 


?} 13 


IFP8,l¥FIi) 


Data File IS 


ASCII 


as 1 


- 


space (@30e) 


ASCII 


83 1 


- 


spare (eOOe) 


~ 


iTi 3 


IFPB.RTSZ 


Rough Table Size (sectors) 


BINARY 


OS i 


- 


zero (eooe) 


- 


b? 1 


IFP6.KSZ 


KEY SIZE (bytes) 


BINARY 


83 3 


IFPB.KOFFS 


KEY OFFSET (bytes) 


BINARY 


90 i 


IFPB.ZEfiOS 


S000000009 


- 


% - 


IFP8.END 


end of indexed file extension to FPB 


LABEL 




FPB 


MAP (3.01) - FILE PARAMETER BLOCK 
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TABLE 8.5.9 - DEVICE KINDS 
t-"A«ILY VALUE DEVICE MNEMONIC 



00-OF 




II 


02 


M 


05 


II 


Q6 


It 


07 


It 


OA 


10- IF 




II 


01 


II 


02 


II 


04 


M 


08 


30-3F 




II 


33 


II 


3F 


50-7F 




II 


53 


II 


54 


11 


73 


80-8F 




v'o-yF 




fC-kf 




II 


01 


I! 


02 


II 


04 


II 


OB 


CO-CF 




II 


C3 


II 


C7 


" 


CB 


II 


CC 


II 


CF 



PRINTER FAMILY 

any Printer AP 

Corrioie (Keyboar-'j oniy) K8 

Seridt Printer SP 

Console (Printer) PC 

Line Printer LP 

CARD FAMILY 

set = CAfd Reader R? 

set = Card Punch P? 

set = 80 coiusn cards only ?8 

set -■ 96 cctusn cards only ?9 

SCREEN FAHILY 

Console (Printer or Screen) AC 

Console (Screen) SC 

IMPLEMENTATION DEPENDANT (B80) 

Async Data Coaia ADC 

Real Tifie Clock RTC 

Industry Cofupatibla Mini Disk (ICHD) DI 

KRZ or PE MAGNETIC TAPE 

P£ TAPE 

NRZ TAPE 

always set 

set = write perait required 

set = Reel tape only MT 

set = Cassette tape only CT 

DISK FAMILY 

Any Disk with 180 byte sectors DK 

Burroughs Super Mini Disk (BSMD) Dfi 

Disk Cartridge DIt 

201-1 Fixed Disk DF 

Disk Pack DP 



DEVICE KINDS 



8-22 



TABLE 8.5.3 - PPB FLAGS 
BIT MASK INT£KfRETATIO« 

7 80 set for special fonnds (printer files) 

set if duplicate file allowed (indexed files? 

6 40 set to use Ffe to update last access and creation date (close) 

5 ?0 set if no label record (isagnetfc tape and printer files) 

4 10 set for conditional open and close 

3 08 set if single area disk file to be created 

2 04 set for generation number check on open or update on close 

1 0? set for non-standard translate (EBCDIC files) 

01 reserved 



FPB FLAGS 
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TASLE e.5.4 - ADVERB FOR OPEN 

mS HASK VALUE INTERPRETATION 

11) 8000 reserved 

14 4000 1 open EXTEND 

13-1? 3000 OTHERIJSE 

" " li;10 free Jiccess (noraial) 

" " 01 lock dccefs {other users msy only read) 

" " 00 lock (no other users dt lowed) 

11-10 OCOO HYUSE 

" " 10 output 

" " 01 input 

" " 11 input-output 

9-6 03C0 reserved 

5~i 0030 ACCESSHODE 

00 iliegil 

" " 01 randosi 

" " 10 sequential 

11 streafl 

3-0 OOOF reserved 



TAeiE 8.5.5 - ADVERB FDR CLOSE 

mS «ASK VALUE INTERPRETATIOW 

7 CO - reserved 

6 40 1 close with no rewind 

" " change real leaving file open 

5-3 38 000 half close 

OU close «ith lock 

" " 10 i close with purge 

" " HI close with reaiove 

" " 001 close with release 

" " - All other coabinations treated as half-close 

2 04 i crunch 

1 02 1 serge overflow region into index region of indexed file 

01 - reserved 



ADVERB FOR OPEN and 
ADVERB FOR CLOSE 
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TABLE 8.6.1 - HFie HAP (3.01) - FILE INFORHATION BLOCK 

INTERPRETATION 



OFF LE» 

St:T 6TH FIELD 






- 


FIB 





1 


FieFLST 


1 


1 


FIBFPfiN 


2 


3 


VFDRIX 


II 


n 


FIBMIX 


3 


2 


VFCTO 




2 


FIBDR2X 


6 


i 


FIBDSTI 


7 


2 


FIBWKAO 


9 


2 


FIfiTRL 


n 


1 


FIBTECH 


12 


1 


FIfiOTHUSE 


13 


1 


FieOPCL 


14 


1 


FIBRBUF 


15 


2 


FIBCDOF 


17 


2 


FI6PTR 


19 


2 


FIBRCSZ 


21 


2 


FIE'EFSZ 


23 


2 


FIBFUTRBUF 


II 


M 


FI8SBD 


25 


2 


FieSWA 


27 


1 


FIBDVCK 


23 


2 


FIBPHTA 


30 


1 


FIB«KDO 


31 


3 


FI6CRN 


3ff 

oon 


t. . 


FIBNDDT 



LABEL 

Filestate 

AssocJdted FP8 segment nuaiber 

Directory Index of associated disk file (disk only) 
11 

Conf iguration Table Offset (vestigial FIB only) 

secondary file Directory Index 

Data Segflient Table Ind'ex for record workarea 

Offset of the Horkarea in the above segment ' 

transfer length 

File TECHniaue 

File OTHERUSE 

OPEN CLOSE flags 

number of Records per Buffer 

self relative address of current 10 descriptor 

Buffer Pointer 

Record Size 

Buffer Size 

number of bytes left in buffer (after PUT) 
II 

Streaai I-G Work Area 

actual device kind 

Peripheral Handling Table address 

current I-O descriptor queue head index 

Current Record Nuaber 

end of non-disk non-console FIB 



FORMAT 



TABLE e.6.3 
BINARY 
B BR 

it 

suescRiPi 

6 BR 
INDEX 
6 BR 
e BR 

T6RI P i i 



BINARY 
SR BR 

B BR 

e m. 

B BR 



TABLE 8.5.2 
AA BR 
INDEX 
B BR 
LABEL 



MFIB^MAP (3,01) - FILE INFORMATION BLOCK 
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iAL'lE e.6.1 - fiMB CM <3.0i) - I Hi ImiraiATIGii DLQCK 



'corrf" - ) 



vVf 


e 


FISCOfiSlZE 


(CONS) 


3!^ 


3 


PICHRR 


(DISK) 


31. 


1 


FIBHDPOS 


(COHS) 


j; 


3 


flBLl'KA 


(DISK) 


3:) 


5 


FlCLOblCALHrtPOS 


(cms) 


^0 


14 


FIBIfMCS 


(CONS) 


-'lO 


2 


FieSEC 


(DliiK) 


42 


3 


FU'MRAP 


(DISK) 


45 


3 


FIBHRU 


(DISK) 


48 


3 


FIBMRD 


(DISK) 


51 


1 


F I BARN 


(DISK) 


'3a 


1 


FIBPRUN 


(DISK) 


ts 


I 


FieSCUH 


(DISK) 


t^v 


2 


FI8ILINK 


(DISK) 


!>5 


2 


FIBTfiB 


(CO^S) 


Si 


- 


FIBL'FH 


(DISK) 


56 


2 


FI8LA1 


(DISK) 


58 


3 


FIBDAl 


(DISK) 


61 


75 


- 


(DISK) 


13i 


~ 


FIBEND 


end of 



nufflber of coluiTins an a coiisole device 

text Record to be Read 

cotuffin position of print head 

last Disk record Accessed 

Logical print Hi-ad Position 

Keyboard Indicators (lights) 

Buffer length in SECtofs 

fjixiffliuffl Record Nusber in current Area 

fiai<iuiUiri Record l^'ritten 

HsKifliUffl Record Declared 

Muaber of Areas allocated 

Prisiary Disk Unit Nufflber (SFFS-unat located) 

Secondary disk Unit Huaber (eFFe=unal located) 

link to indexed file flags (IKE'iTLAG) 

TAB coluffin nucibsr 

iiseffiory Disk File Header 

nufflber of sectors in disk area 1 

sector address of disk area 1 

15 fflore length-address pairs 

F16 for DISK files 



B BR 


e BR 


BINARY 


B BR 


6 BR 


B BR 


B ER 


e BR 


B BR 


BINARY 


SR BR 


B BR 


LABEL 


e BR 


S BR 



LABEL 



MFIB MAP (3.01) - FILE INFORMATION BLOCK 
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TADLE 8.6,8 - HAP VEST.Fie (3.01) - VESTIGIAL FI8 

OFF LE« 

St'T 6TH FIELD I«TERPR£TATIO« FORHAT 



1 VEST.FIB.FLAGS segsient descriptor fiags (=^0488) TAPtE 6.4.? 

1 2 VEST.FIB.eASE segiiient bdsa (poiats to fi testate below) AA fiR 

3 1 VEST.FIS.FS filestate TABLE 8.6.3 

4 1 VESt.FIfi.FPB associated FFB ssgaent namber BINARY 

5 2 VEST.FIS.DRX (DISK) C'irectory Irtdsx of Fi le (? S-bit values) eiNARY 

6 2 VEST.FIB.OFFCT (NON-DISK) Offset of Configuration Table RA &R 

7 1 VEST.FI8.BU (DISK) Disk Unit 



TABLE 8.6.3 - FIB FILESTATE 
BITS HASK VALUE INTERPRETATION. 



7 


80 


80 


Sequential Oraganisation (not Indexed) 


^5 


60 




I-O JIASK 


II 


40 


40 


Output allowed 


" 


20 


30 


Input al lowed 


^J 


18 




ACCESS TECHNIQUE 


II 




00 


Streaa 


II 




08 


Console 


II 




10 


Randos 


II 




18 


Sequential 


2 


04 


04 


End Of File not reached 


1 


ft? 


ft? 


Fila Ha If r!n"H 



Oi 00 Streat 



MAP VEST. FIB (3.01) - VESTIGIAL FIB and 
FIB FILESTATE 
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TARLE 8.6.4 - FIB FILETECHNIQUE 
BIT HASK INTERPRETATION 



7 


80 


L 


40 


5 


20 


4 


10 


3 


09 


? 


04 


1 


02 





01 



Sort Intrinsic (no ddtd transfer) 

Except ion 

Unit Exhausted 

Last tm& was START 

Ust Coffiffl was t'RITE 

Last Coeiis mas READ 

Last C'Qiain «.as not failed Conditional 

Buffering Ahead Invoked (Dynaaic Access) 



FIB FILETECHNIQUE 



8-28 



TABLE 8.7.1 
iff l£H 

zi:]' GJH FIELD 



m' IFIg <3.01) - INUEXED FILE M ORfIA] ION SLOCK 






1 


IKEYFLAb 


11 


M 


IKEYALLOC 


ti 


11 


IFIBflA5 


1 


1 


IFIBKSZ 


2 


1 


IFIBKEN 


3 


1 


IFIBHORERflG 


4 


2 


IKEYOFFll 


II 


II 


IFIMEYO 


6 


2 


IKEYDLU 


1! 


ti 


IFieFIB 


8 


2 


IKEYSLU 


II 


11 


IFIF8RN 


10 


1 


IKEYCflU 


ii 


1 

A 




12 


1 


IFIfeSAREAI 


t3 


2 


FI8DISK0FFI 


15 


2 


IFIBDISKOFFO 


17 


3 


IKEYSIZEI 


11 


II 


IFI8LRN 


30 


2 


IFieSRT 


a? 


1 


IFIBOSA 


?3 


2 


IKEYRTS 


s 


1 


IFIBPARTS 


a^ 


3 


IFIBSIZEGFLOW 



& 208 

29 1 

30 1 



31 
33 



53 18^ 
m? 208 
445 2 

447 1 
4-48 - 

448 2 
450 2 
45'? (SO 
51? - 



IFieCAI 
IFIfi«AI 
IFI6LBI 
IFIBOFFI 

XI XUf/UWX 

IFIB6UFI 

IFIBDRIX 

IFIBBUN 

IFIBDFK 

IFIBLAi 

IFIBDAI 

IFI8END 



I«TERPRETAT10« 

status flags 

nuffiber of areas to allocate initially 

flags 

actual Key Size in bytes 

Key Eatry Size in bytes (one of 8 16 24 32) 

Jiore flags 

close ifiorge output buffer offset 

Key Offset frota base of data record 

close iserge last disk address output 

relative address of related FIB 

close (serge sectors left in out area 

Record Number 

close flierge current area output 

Start of index area 

Sector Offset into first Index Area 

Sector Offset of first Over flow Area 

Size of new Index (sectors) 

Logical Record tosber 

disk- rough table start address ({?OOC'=una I located) 

Overflow Start Area (0FFa=unal located) 

allocated Rough Table Size in sectors 

nuaber of parts in the key 

size of the overflow area 

Index region buffer paraiiieters 

Current Area Index/BINARY 

Maxifflusi Area Index (eFFe=no index allocated) 

last disk sector used in index 

byte offset into index buffer 

I-o descriptor for index region 

index region Buffer 

a siflilar table for the overflow region 

Directory Index of DFH of keyfils 

Disk Unit Number of Keyfjie 

fteiiiory Disk File Header for the Key file 

Length of first disk Area 

sector address of first Disk Area 

15 Bore length-address pairs 



FORfiAT 

1ABLE 8.7.2 

eiKARY 

TABLE 8.7.2 

BINARY 

BINARY 

TABLE S.7.3 

B ER 

8 BR 

e BR 

RA BR 

B Bft 

6 BR 

BINARY 

BINARY 
6 Bk 



B BR 
BINARY 
B BR 
BINARY 
B BR 



BINARY 
B BR 
6 BR 
TABLE ?.3.3 



B BR 
BINARY 

6 BR 
e BR 

LABFL 



MAP IFIB (3.01) - INDEXED FILE INFORMATION BLOCK 
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TABLE 6.7.2 - IKEYFLA6 
BIT mSK INTERPRETATION 



7 


80 


6 


40 


5 


20 


4 


10 


3 


08 


2 


04 


1 


02 





01 



1 = sequential/ = randoa 

hardHdra search successful 

current record pointer points to last record 

read was the. last operation 

overflow region contains useful informatioft 

1 = record pointer is in index rejjion/ = in overflow regio» 

read-next a I lowed 

duplicate keys not allowed 



TABLE 8.7.3 - IFIBMOREFLAS 

BIT «i\SK INTERPRETATION 

7 80 need to allocate an area 

6 40 End Of File detected on randoia read-next 

5 20 rewr i te-overwr i te record search 

4^1 IE reserved 

01 open/close index flag 



IKEYFLAG and 
IFIBMOREFLAG 
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SECTION 9 



LOGICAL AND PHYSICAL I-O 

The task file structures (FPBs and FIBs) (see section 8) relate 
to the actual input-output media through Peripheral Handling 
Tables (PHTs) and queues of 1-0 descriptors. This section 
discusses how 1-0 operations are achieved by the MCP code 
concerned: Master Interrupt Poocessor (MIP) , 1-0 Queue Handler, 
Device Dependent Routines (DDRs) , Master Communicate Handler (MCH) 
and the Openclose slice. 

The contents of the PHTs and 1-0 queues are often important for 
solving problems, especially where hardware faults are concerned. 
They can be printed using the PRINT PHT option of PMB80. 



9.1 COMMUNICATES - MCH AND OPEN CLOSE 

All input-output operations are performed by the MCP. 
A task issues a communicate which is decoded by the Master 
Communicate Handler. Not all communicates are I-O oriented, 
and I-O communicates do not always initiate a physical 
input-output operation . 

Although the MCP performs its own I-O operations to devices, 
all task I-O is performed through a logical file structure. 
This structure is centered on a File Information Block. 
All logical I-O operations (open, close, read, write) are 
performed by a task through this FIB. 

The MCP Openclose slice (slice 17") , contains a Configuration 
Table (Table 9.1.1 - CT MAP) which contains logical device 
information including file-id, multifile-id, and logical 
device status. 

The CT has an entry for each device on the system. When a 
file-open communicate is issued by a task, a link is established 
between the FIB and the CT entry. At the same time, a link is 
established between the FIB and the PHT (see Section 9.2) for 
the channel which accesses the device. The FIB is initialised 
with informaton from these tables and space is reserved for file 
buffers. These links, which are illustrated in Figure 9.1.1, 
should be checked on any dump where a failure in logical I-O 
is suspected. 

The CT is maintained by the AVR task. The contents of 
the CT are analysed by the PRINT OL option of PMB80. 
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LOGICAL AND PHYSICAL I-Q ( CONT . ) 

9.2 PERIPHERAL HANDLING - MIP AND DDRS 

The actual work of input-output operations is performed 
by the Master Interrupt Processor and the Device Dependent 
Routines. The MIP performs only the simplest "read-more" 
or "write-more" controller commands. Ihe DDR for the 
particular controller handles the more complicated I-O 
operations, which are usually dependent on the controller 
involved. 

Information on the physical status of the channel controller 
and device, and the logical status of the DDR for that device, 
are stored in a Peripheral Handling Table (Table 9.2.1 - 
PHTH MAP) and its device dependent extension. The field 
PHT.CIRC.BUF is a circular buffer of historical status information. 
Each entry is two bytes and the field PHT.CIRC.PTR is the 
index of the latest entry. The first byte of each entry is the 
device status received from the controller (see Tables 9.2.4 
to 9.2.8): the second byte is the S-flags which are used by 
the MIP and DDRs to determine the activity which is currently 
being performed on the channel. 

The interpretation of the device status byte is dependent on 
the appropriate hardware controller. S-flags consist of 
two parts. The most significant digit defines the type of 
operation being performed. The least significant digit is 
used, in combination with the channel status, to determine which 
MIP or DDR code should be performed. Each DDR contains a switch 
table to achieve this analysis; these details are not normally 
required, and are not discussed further in this document. 

As a general rule, if the most significant bit of the device 
status is reset then the cause of the problem may be in this area, 
and should be investigated further. 
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LOGICAL AND PHYSICAL I-Q 

9.3 INPUT-OUTPUT OPERATIONS - I-O QUEUE HANDLER 

The PHTs are located at the high-address end of page zero 
memory. Each PHT holds one or more 1-0 descriptor queue 
heads (Table 9.3.1 - QHEAD MAP). 

All 1-0 operations are performed as specified by the top 
1-0 descriptor on the appropriate channel PHT queue. The 
actual 1-0 descriptor is found at a memory location which 
depends upon its origin (for example, the Virtual Memory 
1-0 descriptor is located in the global MCP map VMWA, and 
descriptors for task-initiated 1-0 operations are located 
within the appropriate FIB in the locked TCB slice. 

The descriptor queues are analysed by the PRINT PHT option 
of PMB80, and the queue structure should be checked for 
consistency, starting with the queue heads and following 
the links to the descriptors. 

A queue head contains a flag field (Table 9,3.2) giving the 
status of the queue, and current descriptor and final descriptor 
memory addresses. 

Note that the queue head contained within DISK PHTs does not 
point to a queue of 1-0 descriptors but to the disk parameter 
area (Table 9.2.3 - DSKPM MAP). 

Each 1-0 descriptor has the same format (Table 9.3.3 - lODESC 
MAP) . Console 1-0 however, uses some of the fields in a 
different manner 

Field lODFL indicates the operation to be performed, and the 
result of the 1-0 operation when completed (see Table 9.3.5). 
Field lODPM is the task-id (Table 7.6.2) of the task which 
requested the operation. 
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H . 1 . T 



LOGICAL AND PHYSICAL I-O STRUCTURE 



FIB 




lODESCRIPTOR 



FILE 
BUFFER 



logical 
(task- 
s' related) 
' file 
structure 



FPB 



RECORD WORK AREA 



LOGICAL DEVICE TABLE 



■^ 



CT 



Dhysical 
>-l-0 
structure 



PHYSICAL CHANNEL TABLE 



1-0 QUEUE 



J 



LOGICAL AND PHYSICAL 1-0 STRUCTURE 
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TABLE 9.1.1 - CT ^F (3.01) - CONFIGURATION TABLE 



OFF LEH 

SEI GTH FIELD 

1 CTFLAG 

1 1 CTFLAG.DISK 
? 6 CTCANO 

8 7 CTFLIS 

15 1 CTRLNO 

15 1 CTNOSC 

16 1 CTNOTK 

17 1 CTDRYL 

IB 1 cr&yNO 

19 1 CTDVCK 

?0 1 CTPHTA 

?S i CTQHM 

33 1 CTRSKN 

23 i CTCMTO 

£4 2 CT.KB.SS.LIHK 

?^ 2 CTIjHLA 

?6 ? CTRCSZ 

26 2 CT.KB.SP.LINK 

26 2 CTDDIN 

28 2 CT.DYNAHIC.LINK 

30 - CTSIZE 



USE 



Configuration Table FLAGs 

special disk f'isgs 

pii'/sical id 

MULTIFILE, VOLUME/ or PACK ID 

Reel nutber for tapes 

Nufflber of sectors per ttAck idisk devices) 

Number of TRACKS per CYLINDER 

Directory length 

Device Number ("A"/ "B", "C" etc.) 

DEVICE KIND (CHS STANDARD) 

PHT address for this device 

Sucue Head Offset for this device 

ESCT task- id of task holding this device 

nuiBber of open files on this device (disks only) 

LINK of Self-Scan CT entry (Keyboard CT only) 

used for keyboard screen CONSOLE coisbi nations 

Disk sector nuniber of first DFH 

Record Size (ncn disk) 

LINK to Serial Printer CT entry 

usei for keyboard printer COfxSOLE file coflibi nations 

Disk directory inforiiation 

ffieifiory LINK work area 



FORHAT 

TABLE 9.1.? 

ASCII 

ASCII 

BINARY 

BINARY 

BINARY 

BINARY 

ASCI! 

TABLE 8.5.? 

AA 8R 

INDEX 

TABLE 7.6.? 

BINARY 

RA Efi 

e BS 
B BR 
RA PR 



RA BR 
LABEL 



TABLE 9.1.? - CONFIGURATION TABLE FLAGS - FIELD CTFLAG OF HAP CT 
DITS HASK INTERFRETATIOi^ 



7 


80 




1 


40 




5 


?0 




4 


10 




3 


18 




2 


40 




1 


20 







01 





in CT 



device POtiERED OFF 

device REUINDING 

this entry Llf^KED to next entry 

device READY 

MULTIFILE MEDIA 

SYSTEMS DISK 

device UNLABELLED 

NOT LAST ENTRY in Configuration Table 



CT MAP (3.01) - CONFIGURATION TABLE and 
CONFIGURATION TABLE FLAGS - FIELD CRFLAG OF MAP CT 
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I TABLE 9.8.1 ■■ PHTH (3.01; - PERIPHERAL HANDLING TABLE 



OFF LEiN 

aiT blH FIELD 









- PHTHD 
2 PHTDDR 



16 1 

17 1 
IB 1 
19 1 



■>2 
28 



e 

2 
2 
1 
29 1 



m 1 

31 1 

:i2 1 

Ji 1 



3^- 1 



35 - 



PHT.CIRC.SUF 

PHT.eiRC.PTR 

PHTSrt 

PHTSTAT 

FHTSP-GS 

PHTBLIH 

PHTRCLN 

PHTE-FTR 

PHTRCLT 

PHTPSZ 

PHT9FIN 

PHTADDR 

PHTS'JBCHAN 

PHIGUBPRI 

PHTfiaXQNO 

PHTHQNO 

PHTCQNO 

DUTCXin 

QHL'OFST 



USE 



ffieffiory address of DDR slice descriptor- 

QCiOOCe for a CHANNEL EXPANDER 

hisfcaricil buffer of two byts entries 

status byte iwi s-flag byte (sae below) 

index of current entry in buffer above 

Status H:i.3k (stared by DDR) 

STATUS byte obtained from hardware 

DDR S-FLr^!"S (what is the device doing ?) 

length transferred so far 

record terrgth 

buffer pointer 

record length left to transfer 

physical controller buffer size (transfer length) 

accufflulation of error conditions 

to be transferred to lODESC 

channel address (one bit set) 

sab-channel address (channel eKpander) 

sab-channpl priority 

nuisber of bytes for q--heads 
ti 

index of q-head o+ queue being processed 



NOTE 1 if PHTSil LOGICAL-OR PHTSTAT is not = OFFS 
then an exception condition has arisen" 

fCTE 2 a queue entry is 6 bytes long; aost channels 

have 2 I-O queues giving a siaKirouiTi queue of @0C5 
and possible current queue nuniDsrs of G009 or S068 
or '3Fr§ if no queue is in use 

^DTE 3 the remainder of this iT,ap is the first 1-0 queue 
for this channel/ refer to TABLE 9.3.1 



FORMAT 

LABEL 
AA BR 



INDEX 




NOTE 1 




TABLE 9.?. 


4 


TABLE 9.2. 


9 


e ER 




6 ER 




AA BR 




B BR 




BINARY 




TABLE 9.3 


■> 


TABLE 9.2, 


V 



NOTE ? 

II 

NOTE 2 
LABEL 
NOTE 3 



PHTE (3.01) - PERIPHERAL HANDLING TABLE 
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lABLE 9.?. 2 - CHANNEL ADDRESSES 



OmHEl ADDRESS 




1 
2 

3 
4 
5 
6 
7 



01 
02 
04 
OS 
30 
90 
40 
80 



CHANNEL ADDRESSES 



iftui..!. /.C.J - u:/^rl■l liMr \o.^jii - rni i^ic^ri rf;r\tin£.itn HUtn 



iTf LEN 

SET biH FIELD 



U.yt. 







I 

2 

3 
5 

7 

8 
10 

le 

16 
18 
19 
20 1 
:?1 1 



1 

1 

1 

2 

1 

1 

1 

2 

2 

2 
■p 

1 
1 



DSKFST 

DSRPFL 

DSKP. RETRY. COUNT 

DSKr.yRITE.READ.ftETR rsad-^jfter-wri fce ratrv count 



•flags U20ci by the L'lSfi L'DH 

count cf .a!! retrie-; on the drive 



DSI(P.RECORL>.SIZl 

D3KPF5 

DSKPSF 

DSKPFl 

DSKFCA 

DSKFD? 

DSkP(^A 

DSKPAO 
DSKPCS 
D3KPIS 
CSKPPS 
I'SKPSS 
PSKPES 



buffer size ''record size for scoltcr-g-itf.er) 

fuiicfcion 2 

initiil value of s-flags 

function 1 

Disk Address (zero rslativa sector nuistic-r) 

initial disk address 

Maxiffiuifi Disk Address 

Address Offset 

Cyl inder Git inask 

Initial Sector of this transfer 

Prifflary Status byte 

Secondary Status byte 



FORMAT 

LABEL 

BINARY 
8INAR.Y 
B BR 

TAeLE 9.9.9 

B GR 

B 8R 
G BR 
Ef BR 
e BR 

BINARY 
TABLE 9. 2 A 

it 

LABEL 



DSKPM MAP (3.01) - PHT DISK PARAMETER AREA 
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IftfiLF: 9.?.''i - DISK STf'iTUS BYKS 
mifiARY STATUS; 
[ilTS MASK INIERPRKIATION 



7 


80 


6 


40 


5 


?0 


4 


10 


3 


08 


y 


04 


1 


0? 





01 



= drive NOT UK (logical AND of bits 9 4 6) 

= SEEK INCOMtltlh aftar a seek opc-rafcion (otherwise 1) 

= drive HOT UPtK^^TIONAL 

= refer to SLCQiaOARY STATUS (see below) 

= SEARCH IHCQMFltTF after search opei'jtioH (otherwise 1) 

- UUj or CYLIHDEP. on ra^d; write or search oper-stio» 

= SEht( COMPLETE after seek operation (otherwise 1) 

= upper drive; 1 = iower drivs 



a:LO?;i)ARY status j 

OTTS HASK IHIERPRtTATIOfJ 



7 


80 


A 


40 


5 


?0 


4 


10 


3 


08 


2 


04. 


1 


02 





01 



^ DCMICE ERROR (e.g. switched off) 

= ILLEGAL COHIiAMD sequence used 

= LRC (parity) error 

= required SECTOR NOT FOUNJ 

= drive WRITE lilfllBIT 

- ILLEGm'iL SEEK operation (otherwise 1) 

= head NOT OH CYLINDER required for read/ write or search 

1 - EQUAL condition after a search operation (otherwise 0) 



DISK STATUS BYTE 
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TASLE 9.9.5 - CASSETTE STATUS BYTE 
BITS MASK INTERPRETATION 



/ 80 1 = device OK (refer to the soft controHer status values) 

7 80 = device NOT GK (refer to the other bits b'^ioH) 

6 40 = device NOT AyAILABLE 

5 20 = im OF REEL detected 

4 10 = device ERROR 

3 08 = INyALK' mmm sequence 

2 04 = TAPE HARK detected 

1 02 i = DATA STRODE FAIL 

01 1 = WRITE INHIBITED with write type coMand 



TABLE 9.2.6 - SELF SCAN STATUS BYTE 
WJE If-^TERPRETATIQN 

FF OK 

W ERROR 



CASSETTE STATUS BYTE and 
VALUE INTERPRETATION 



9-9 



iO cps SERIAL PRINTER: 
BITS HASK INTERPRETATION 

7 80 = NOT OK 

A 40 = VOLTAGES BAD 

5 aO = m PAPER 

4 if> always set 

3 Oe = FORilS MOTOR ERROR 

2 04 = CARRIER ERROR (jdMsd or invalid position) 

1--0 03 always set 

l?0/ieO cps SERIAL PRINTER: 

CITS HASK INTERPRETATION 



7 80 1 = OK, = NOT OK (refer to the other bits below) 

6 40 = COVER OPEfl; or RETRACT TAPE CtlOiitf! 

5 20 = KEDIA ERROR 

4 10 0'= HEAD RElRACT FAILED 

3 08 always set 

2 04 = CARRIER ERROR (jaisjiad or outsidt; lidiits) 

i 02 always set 

Oi 1 = set request 

LIfiE PRINTER: 

I'lTS MASK INTERPRETATION 



7 


eo 


= NOT OK 


6 


40 


= NOT READY 


5 


?0 


= NO PAPER 


4 


10 


= ERROR 


3 


08 


= END OF PAGE 


2--0 
cor 


07 
It. . 


always set 



PRINTER STATUS BYTES 
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TA8LE 9.2.7 - PRINTER STATUS efiES (cont.) 

MALIJE INTERPRETATION 

:>7F OK 

'7B (60,J?0,1S0) CARRIER JAfi 

■77 (60? FORMS JA« 

<if" (1 90, 180) HEAD RETRACT ERROR 

5F' <60,1?0.180-Lf) fORHS ERROR 

3r (<50,1?0;!80;L?) ERROR 



TABLE 9.2.8 - KEYBOARD STATUS BYTE 
•v^^LUE INTERFRETATIOK 

l-F OK 

if eUFFER OVERFLOW 

'3r CISCONNECTES 



PRINTER STATUS BYTES (cont.) and 
KEYBOARD STATUS BYTE 
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TAPLiT s\r'.y - S-FLAGS - DDR STATUS BYTE 
MT3 HftSK INTERPRETATION 



7 ac = READ/ 1 = WRITE 
<i-4 70 CONTROLLER TYPE 
3-0 OF CURRENT DDR STATUS 

LTINTROLLER TYPE (S-FLA5B AND 9708): 

^JftLUE INTERPRETATION 



1 



KB, DI 

1 SP 
? SS 
3 CT 

6 m, M, DP 

? LP 

im STATUS (S-FLAbS AND @0F9): 

mM IfiTERPRETATION MSK USE 






normal arous?.! 








1 


special -jtousaI 








2 


waiting on MCH 








3 


first normat data 


request 






4 


first special data 


request 




search i 


5 


special request 






search 3 


6 


request 1 






search 3 


7 


request? 






data transafer 


8 


request 3 






seeking 


9 


request 4 






special (end of cylinder) seeking 


A 
B 


request 5 
request 6 






read after write - read less read 


C 


request 7 






last write on cyi inder 


D 


request 8 






last transafer 


E 


rinai request 








F 


noraal data requss 


t {handled 


by HIP) 





S-FLAGS - DDR STATUS BYTE 
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TABLE 9.3.1 - QHEAD HAP (3.01) - IQ DESCRIPTOR QUEUE HEAD 

OFF LEH 

SET 5TH FIELD USE FORMAT 



1 QEL Queue Flags TABLE 9.3.? 

1 2 QCD address of fie!d IGDIK af first lODESC {TA5LE 9.3.3) AA BR 
3 2 QFD address of final 10 descriptor on queue AA BR 

5 1 QBA Drive Address (ffluftidrive control lers) 

6 - QM = LABEL 

LABEL 



TABLE 9.3.? - QUEUE FLAGS - FIELD QFL OF «AP QHEAB 
BITS mSK INTERPRETATION 



7-i CO reserved 

5 20 1 = queue espty 

4 10 1 = queue not ready 

3 03 1 = readiness changed 

2 04 1 = return errors if not ready 

1 0? 1 = dequeue descriptors if not ready 

01 1 = A'.'R help task .ftust be run 



QHEAD MAP (3.01) - 10 DESCRIPTOR QUEUE HEAD and 
QUllUE FLAGS - FIELD QFL OF MAP QHEAD 
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meLE 9.3.3 IQ&LSC hap (3.01) - lU t'LtiLKiPlUK 



ClfT LEN 






StlT GTH FIELD 




2 


CONCHL 




11 il 


lODCL 




8 1 


CONILKFLG 




li II 


lODFL 




3 2 


CONPHLK 




II !l 


lOOLK 




5 2 


CONBS 




H 11 


I0D8S 




7 2 


CONSL 




tl 11 


lODBL 




9 1 


CONPPH 




9 1 


lOI'PH 




10 1 


CQJ^LfiADV 




10 2 


lODDA 




11 2 


COMCOLNO 




12 1 


lODDU 




13 1 


lOD.DISK.RE 


TRIES 


13 6 


COflCDypH 




14 5 


lO&.CRC 




19 1 


lODSPO 




il II 


CQNSPO 




rO - 


lOfO 





USE 



Coromunicate H,3nd!ei liioiiiory Link 

Descriptor Chain Link (lODLK of neKt daicriptor) 

InterLocK FLab 

Descriptor FLags 

fiefflory iddress of associatod PHT 
II 

Buffer Start address in aefflory 
II 

Buffer Length 
II 

Print ParsHetar 

farifioter (iioids task- id of requesting task) 

number of linas to advance 

Disk Address(2ero relative sector r.uffibsr 

coiucn nuabsr 

Disk Unit - drive ni.!iT.ber 

count of retries m this operation 

cursor-head-drive paraiTieter bytes 

ICHD CRC 

bit settings for self scan spo 



FOR.HAT 

£R BR 
SR BR. 
TABLE ?.3.i, 

H 

AA BR 
« 

SR BR 

n 

B BR 



TABLE 7.6.5 
BINARY 
e BR 
B BR 



LABEL 



lODESC MAP (3.01) - 10 DESCRIPTOR 
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•lASLE 9.2.4 - 10 DESCRIPTOR INTERLOCK FLAGS 

BITS flrlSK WTERPPfTfiTION 

l-i CO DESCRIPTOR SIATUS 

5 ?0 = split buffiT 10; 1 - nor.i'.ji buffrr 10 

4-2 IC 10 RESULT 

1 0? 1 - buffer not updittd fay systeis 

01 1 = buffer cnpty 

KSCfilFTOR STATUS (lODFL AND QCOt'): 

WLUE INTERF'RETATIOfl 

!X' nothing Hiitifsg for- this 10 

OA D'.II Trr ,,-.;.:,.■ .--_- JL l : _ T-i 

40 TASK waiting for this 10 (see lulipil cf IiiiJfKC TACLl 9.3.3) 

yALtJE INTFRf'RElAlja;^ 

iC OK 

18 LRC (parity) enrif 

14 ss.^.rch failed diisk only) 

iO ^co!: error {^r'lsk onlv* 

CC invii id requt'tit 

OS sector iiat found (disk only) 

C4 device switched f;ff 

<X) mi i a is wr i te inhibit (wr i te m I y ) 



10 DESCRIPTOR INTERLOCK FLAGS 
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SECTION 10 



10. CMS DISK ORGANISATIO^? 

The information on all disks used on CMS systems (excluding 
Industry Compatible Mini Disk - ICMD) is stored in files 
under the same logical structure. The layout and contents 
of a disk are sometimes relevant to diamp analysis, and so 
a description of the CMS disk organisation is included in 
this document. 

The format of Key files, program files, and program dimip 
files is described, as this is also relevant to the analysis 
of some memory dumps. 

The following utilities may be used to examine the information 
on a disk: 

PD shows the contents of the disk directory namelist 

KA analyses the disk directory and available table 

LIST may be used to print any sector (e.g. LIST SYSMEM 
100 1) 

DA prints and formats various items 

Refer to the CMS Software Operational Guide (form number 2007258) for 
operating instructions for these utilities. 



10.1 DISK AREAS 

Figure 10.1.1 shows the structure of the main elements of 
CMS disk organisation, which are: Track zero, a non-file 
directory: a file directory consisting of a namelist 
and a disk file header list: and the remainder of the disk 
which is divided into data areas. 



10.2 TRACK ZERO 

Track zero of CMS disks is used for two basic functions: 
a disk label which identifies the disk; and a bootstrap 
of machine code to enable the CMS system software to be 
started using this disk. 

2015400 10_1 



10. CMS DISK ORGANISATION (CONT.) 
10.2 TRACK ZERO (CONT.) 
10.2.1 DISK LABEL 



The disk label is located at sector zero of all 
CMS disks (see Table 10.2.1 for the format). The 
contents of many of the fields in this label, especially 
pointers to the directory items, must be valid if 
the integrity of the information stored on the disk 
is to be preserved. 



10.2.2 BOOTSTRAP 



The bootstrap area lies in sectors 2 to 25 on all 
CMS-initialised disks. However, the bootstrap is 
written in machine code, which varies with the hardware 
used. For example, the B80 bootstrap is different 
from the B800 bootstrap. Only disks initialised on a 
CMS B80 system are guaranteed to contain a valid B80 
bootstrap. Also, the bootstrap may change from release 
to release to accommodate new features. 

Since the bootstrap code performs the memory dimip 
routine (PK4 or PK5) , it is important that the correct 
bootstrap is present in this reserved area of the disk 
used to bootstrap the system (PK2) when a memory dump 
is to be taken. 

The bootstrap is written to sectors 2 to 25 by the IN 
and RF functions of the Stand-Alone Utility, which 
takes the information from the disk file called CMSBOOT. 

Disks used to take memory dumps from a system running 
a given level of MCP should be initialised using the 
same level of Stand-Alone Utility and CMSBOOT file. 



10.2.3 BAD AREA LOG 



This lies in sectors 30 and 31 of all CMS disks. 
It is not however, fully implemented on the B80 
3.01 system. Refer to section 10.3.1 for more 
information on bad areas. 



10.3 DISK DIRECTORY 

Although the three items of the disk directory are addressed 
independently by the disk label, the disk directory is 
usually a contiguous area on disk. Usually (though not 
on fixed disks initialised on the B80) this area follows 
directly after track zero (i.e. sector 32 onwards). 
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10. CMS DISK ORGANISATION (CONT.) 
In "J nrcv nTDTjrrnnDv .'r~-,~<K-,m \ 

10.3.1 AVAILABLE TABLE 



The area is also known as the "non-file directory" 
because it addresses those parts of the disk which 
are not allocated to disk files. 

This section of the directory references all areas 
of the disk which are not assigned (see Table 10.3.1). 
When the disk initialise routine discovers a bad 
area of disk, an entry is made in the available table 
with length zero and start and end addresses reversed. 
On some disks, areas are reserved for Field Engineering 

purposes: this i R acbio^roH Ktr /-onoi <^<-.vi »^^ 4--U,^ ^„_ 

to be "bad". A "ghost entry" is also made in the 
available table which has a start address equal to zero 
and an end address equal to the last sector address 
on the disk +1, and a length of zero. 



10.3.2 FILE DIRECTORY - NAME LIST 

This is a contiguous block of sectors containing 
the names of the files on the disk (see Table 
10.3.2). The MCP may reserve areas of disk by 
inserting a temporary entry with 4*82 in each byte 
of the name field. Unused entries have *t^81 in 
each byte of the name field. Each entry references 
an entry in the other part of the disk file directory, 
the DFH list, in the same relative position. 



10.3.3 DISK FILE HEADER (DFH) "LIST 

Each sector in this area may contain a Disk File 
Header. The disk file header includes the detailed 
information about the file which it references. This 
information includes the type of file, the number of 
tasks using the file, and the location of the file areas, 
(See Table 10.3.3) . 

Allocation and de-allocation of disk space consists 
of updating both the non-file directory and the file 
directory. If the system fails while this is in 
process, then areas of disk may not be assigned, or may 
become assigned twice. This symptom may be determined 
by executing the KA utility for the disk. 
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TO PMS niSK ORGANISATION (CONT. ) 



10.3 DISK DIRECTORY (CONT.) 
10.3.4 SYSMEM FILE 

The first file in the directory of all CMS disks is 
called SYSMEM. The DFH for this file references the 
entire disk from sector O to the end of the disk. This 
file may not however be accessed by user programs, and 
does not appear in the analysis performed by the system 
utilities such as PD. 

10.4 KEY AND TAG FILES 

CMS files with indexed organisation consist of two files on 
disk: the key or tag file, and the data file. The key file 
contains the record keys and relative record pointers to 
the data file. A tag file (or null key file) does not contain 
the record keys, and the indexed "file" may consequently 
only be accessed sequentially. 

Figure 10.4.1 shows the layout of a key /tag file and Tables 
10.4.1 and 10.4.2 describe the formats of the areas concerned. 

The first sector of a key file is the Key File Parameter Block 
(KFPB) . This is followed by a rough table, an index region, and 
an overflow region. The length of each entry in the key file 
is determined by the length of the key as follows: 



key length not > 5 bytes 
key length not > 13 bytes 
key length not > 21 bytes 
key length not > 28 bytes 



entry length = 8 bytes 
entry length = 16 bytes 
entry length = 24 bytes 
entri' length = 32 bytes 



10.5 PROGRAM (S-CODE) FILES 

COBOL, RPG, MPLII and NDL program files all have the same 
basic structure (see figure 10.5.1). The file is one 
contiguous area on disk and has a Program Parameter Block 
(PPB) in the first sector (see table 10.5.1). The PPB contains 
reference information about the program and pointers to items 
within the code file. 

The Program Segment Table (PST) (see Table 10.5.2) contains 
descriptors pointing to the S-code segments of the program. 
The data Segment Table (DST) (see table 10.5.2) contains 
descriptors referencing the data segments of the program. 
The CCB Preset Area (CCBPA) contains the COP Table for COBOL 
and RPG programs. The Internal File Name Block (IFNB) con- 
tains a list of file names of the files used by the program. 

When a program is executed, these elements of the code file 
are used to build the Task Structure discussed in section 8. 
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10. CMS DISK ORGANISATION (CONT.) 

10.6 PROGRAM DUMP FILES 

A program dump file consists of three parts (see figure 
10.6.1) which reside in two areas of disk. These three 
parts are the PPB, all the data segments (excluding FIBs) , 
and the TCB. All of these items are obtained from the run 
structure of the task. 

The PPB is obtained from the program code file with bytes 
178-179 updated to contain the logical record number of the 
start of the TCB in the file. The data segments (excluding 
locked segments) are copied from the tasks 's virtual memory- 
file, all segments being updated from the memory copy, if 
the segment is present in memory as well as in the Virtual 
Memory file. Each segment starts on a sector boundary. The 
TCB is a copy of the TCB from memory, including all locked 
segments . 
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10.1.1 CMS DISK ORGANISATION 



trackO 




FILE AREAS 



CMS DISK ORGANISATION 
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10.4.1 KEY FILE ORGANISATION 




KFPB 



ROUGH TABLE 



INDEX REGION 



OVERFLOW REGION 



KEY FILE ORGANISATION 
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10.5.1 



PROGRAM FILE ORGANISATION 




PROGRAM 

S-CODE 

SEGMENTS 



PROGRAM FILE ORGANISATION 
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10.6.1 PROGRAM DUMP FILE STRUCTURE 



/ PPB 



DISK AREA 

#1 




DATA SEGMENTS 



Pink 
Link 



DISK AREA 

#2 




SLICE 
DESCRIPTOR 



TCB 



SPARE 



PROGRAM DUMP FILE STRUCTURE 
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TABLE 10. 2-. 1 - DISK LABEL 



BYTE 



0-3 




4-9 




10 




11- 


20 


21- 


27 


28- 


29 


30 




31- 


36 


37- 


50 


51- 


75 


79 




50- 


83 


84- 


88 


C9- 


94 


95 




96- 


■97 


98 




99 




IOC 


» 


101-103 



ICi 



CONTENTS 

"VOLl" 

Serial no. 

Blank (Access coce) 

"SL9INTERM" 

Cartridge identifier 

"59" (Systen Interchange code) 

Zero (Pack Code) 

Reserved scratch 

Owner's Identification 

Reserved scratch 

Blank 

"V0L2'' 

Initialisation Date (YYDDD) 

Initialising System (eg.''BDS'') 

"R" if restricted c<?rtricge 

No. of Cy I i niers 

No. of Tracks-Cylinder 

No. of Sectors-Track 

No. of Sectors for Directory 
Name List 

Sector Adcress of Directory 
Name List 

No. of Sectors for Available Table 



C3 



01 







SIZE 


DATA COCE 






04 


E(ECOIC) 


06 


t 


01 


E 


10 


E 


07 


A(SCII ) 


02 


E 


01 


E 


06 


-- 


14 


A 


28 


-- 


01 


E 


04 


E 


05 


E 


06 


E 


01 


A 


U2 


BdNARY) 


01 


B 


01 


B 


01 


B 



DISK LABEL 
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TABLE 10.2.1 - DISK LABEL cont. 



2015400 



105-lor Sector Adcress of Available Table 03 



108-109 Maximum no. of files 



110 Unit of AllocationCsectors) 



DISK LABEL COnt. 



S^^E CONTENTS SIZE DATA CODE 



8 



es 02 8 



01 B 



111-113 Sector Address of First Tile 03 S 
Header 

11*"118 Reserved protected 05 

119 Integrity Flag (0 = OK) gj ^ 

120-1?S Actual rrrnr r„ii„» «^ 

126-131 Bad Sector Count 06 E 

132-135 Reserved for MTR q^ 

136-179 Reserved Scratch 3^ 
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TABLE 10.2.2 - BAD AREA LOG 



BYTES CONTENTS 



Q-1 Total of bad allocation units recorded in this log 

2-31 Binary zero. Reserved for possible future expansion 

32-33 Address of first of group cf contiguous bad allocation units 

34-35 Nu (Tb er of allocation units in group 

36-359 81 more addr ess/ le ng th pairs 



BAD AREA LOG 
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TABLE 10.3.1 - AVAILABLE TABLE BLOCK 



BYTE CONTENTS SIZE DATA COOE 



0-1 Length of available area in 02 B(INARY) 

allocation units *♦ 

2*3 Address of first available 02 B 

allocation unit ** 

'•■S Address of last available 02 B 

allocation unit +i 

6-173 28 more 6 byte entries 166 B 

174-179 Sterile area (always zeroes) 06 B 

** An uniJ«!Prt onfrv h a«; lon/^t-h = to-» «iir> i.w -. _ ^ i - _ .. 

allocation unit adcresses = i. 



AVAILABLE TABLE BLOCK 
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TABLE 10.3.2 - NAME LIST BLOCK 



BYTE 

0-11 

12 

13 

14-15 

16-175 



CONTENTS 
File Identifier 
Reserved (Blank c^a^acte^) 
D j rec tory Inde x 
Header Sector Address 
Ten more 16 byte entries 



176-179 Zero 

Notes 



SIZE 


OAT* CODE 


12 


Atscin 


01 


A 


01 


BdKARY) 


02 


B 


160 


A or S 


04 


B 



Available directory entries, i-e. entries which Oo not st 
present correspond to files but could do so in the future 
contain «8C in each of the first 12 bytes of the entry. 
Bytes 14-15 of such entry contain the disk address cf the 
sector holding this directory entry- 

A directory entry whose corresponding file header is that 

of a temporary file* i.e. has not been closed with locki- 

contains «81 in each of the first 12 bytes of the entry 
and the sector address of the header in bytes 14-15. 

Since each block of the directory name list can hold 
eleven entries and the total no. of heaflers may not be a 
Bultiple of eleven' it ts possible that the last sector 
of the name list contains unusable entries. Such ertrjes 
are narked by *82 in each of the first 12 bytes of the 
entry and zero in bytes 14-15. 

The directory index gives the ordinal position of this 
entry within the directory. The number is recorced moculo 
256. 



NAME LIST BLOCK 
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TABLE 10.3.3 - DISK FILE HEADER (DFH) 



BYTE CONTENTS 



0-11 File Identifier 

12 Blank 

13 File TypeCsee table 6.^.A.2) 
l^-ir Flags 

18-22 Creation Date (YYDDD) 

23-27 Last Access Oate (YYODD) 

28-29 Record size (in bytes) 

30-31 No. of records per block 

32-33 NO. of sectors per block 

34 I aplenen t ation Level No. 

35-37 Maximuiii file size (records) 

38-;o Save factor (0-999) 

*1 Maximum area in use (0 = None) 

A2-43 No. of records in last area 

4A-45 Generation No- 

46-47 No- of spare chars, in last record 
(Stream I-O) 

48-54 Pack-id of overflow pack 

55 User count 

56-57 Area Bit Map 1 

58-59 Area Bit Map 2 

60-61 Address of 1st File Area 

62"63 Size of 1st File Area 



DISK FILE HEADER (DFH) 
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02 


8 


01 


5 


03 


B 


03 


A 


01 


B 


02 


B 


02 


B 


02 


8 


07 


A 


01 


BU 


02 


BM 


02 


6M 


02 


8S 


02 


BS 
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TABLE 10.3.3 - DISK FILE HEADER cont . 



BYTE 



CONTENTS SIZE NOTES 



64-123 15 more address-size pairs 

124-128 Reserved for implementation 

dependant overflow pack pointers 

129-131 No. of records in file 
NOTET. 



60 B 
05 B 

03 3 



A: ASCII characters 

8: Binary number 

F: Flags. 

Bit set = file has been "crunched" 

Bit 1 set = rough table valid 

Bit 2 set = file has section on overflow pack 

Bit 3 set = single area file 

Bit 4-31 ere currently, unassigned 

I: File identifier 

The contents of the file-id field are always the same as 
the contents of the file-id in the corr csoondinc entry in 
the directory name list (even to being filled with «8C or 
IBlfor available entry and temporary entry 

r espec t i ve I y ' • 

U : User counts 

Bits 0-2 " total number of users (7=lccked) 

Bi t 3 - spare 

Bit 4 - number of output users. 

Bits 5-7 - number of lock access users 



DISK FILE HEADER cont. 
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TABLE 10.3.3 - DISK FILE HEADER cont. 



Area bit maps are 16 bit fields in which each bit 

represents one of the 16 possible file areas- The most 

significent bit in the bit map corresponcs to the first 

file area and the least significant bit to the 16th srea. 

The bits in area bit map l have the following 
signif icanceo- 

Set = area allocated and on this pack. 

Reset = are not allocated 

or on other (overflow) pack. 

The bits in area bit map 2 have the follouina 
significance. 

set = area allocated and on other pack. 
reset = area not allocated or on this pack. 

S :- 

Addresses anc sizes of file areas are in tens of the 
allocation unit of this pack which is an integer multiple 
of sectors and fixec at initialisation time. 

Addresses for areas on an overflow pack are not 

necessarily correct, sizes for areas on an overflow pack 

are correct and are given in terms of the sUocation unit 
of this pack . 



DISK FILE HEADER cont. 
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TABLE 10.3.4 - DFH FILETYPES 



TYPE CODE 

Normal data <-0") «00 

Source language fOl " .«0E 

Sourcelibrary tOf 

Ordinary program (5-coae) <10 " '13 

Interpreter for BDS 114 - »17 

Interpreter for B700 118 - flB 

Interpreter for B17QC IIC - i»lF 

Sysraam *20 

VM file «30 

Indexed ("I") #80 ** 

Key file ("K") |81 

** Value ttSQ never appears in file header tut is used in 

FPB to indicate that an incexed file is being opened. 



FILETYPES 
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TABLE 10.4.1 - KEY FILE PARAMETER BLOCK (KFPB) 



BIfTE 



1-2 

3-9 

10-21 

22 

23-27 

28 



29-31 

32-33 

34 

35-37 

41-43 
44-4 6 



CONTENTS 



iBpleinen tat ion Level No. 

Spare 

Pack- id of data file 

File- id of data file 

Blank 

Space for i mo lementat ion cefined 
link to data file 

KFPB flaqs - true if bit set 



Bit 
Bit 1 
Bit 2 
Bit 5 
Bit T 



B80 created rough table 
B700 created rough table 
B1700 created rough table 
Data file is a dual pack file 
Duplicates allowed 



Relative record not at start 
of rough table 

Length of rough table in sectors 

Spare 

Relative record no- of start of 
over f low regi on 

Size of overflow region in sectors 

Relative record no. of start of 
index region 

Size of index region in sectors 



IZE 


NOTES 


01 


8 


02 


- 


07 


A 


12 


A 


01 


A 


05 


. 



01 



03 

02 
01 
03 

03 
03 

03 



B 

B 



KEY FILE PARAMETER BLOCK (KFt'B) 
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TABLE 10.4.1 - KEY FILE PARAf-lETER BLOCK cont. 



BYTE CONTENTS 



^7 Spare 

*8~49 Size of key part in bytes 

50-51 Offset of keypart from base of 

data record in bytes 

52-55 Zero 

56-179 Spare 

NOTES: 



IZE 


NOTES 


01 


- 


02 


B 


02 


B 


OA 


BO 


124 





A : ASCII characters 

B ' Binary number 

C : Set-Reset by dose 



KEY FILE PARAMETER BLOCK COnt. 
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TABLE 10.4.2 - ROUGH TABLE ENT'RY 



BYTE " Highest key value in this group of index 

•J sectors»ieft justified'birary zero filled. 



r r- fci T o wc T 



(ENTRYS2 - 3) * Lowest sector address in this group of 
(ENTRYSZ - 1 ) sectors. 



NB 



1) The forirat of rough table is iraplementation cependant. 
All isipl'esiertations are» however* required to assign 
sufficient disk space to accomodate a rough table. 
fomatted as above» with a group size of 32 sectors. 

2) The rough table is not undated if the record 
corresponding to the highest key in a group of sectors »s 
deleted- 



ROUGH TABLE ENTRY 
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TABLE 10.4.3 - KEY ENTRY (INDEX OR OVERFLOW) 



BYTE * Key value»left iustified»binary zero filled 

CENTRYSZ - ^i) 

(ENTRYSZ - 3) - Relative record no. Mithin data file of 
CENTRYSZ - 1) keyed record. 

NB 



Deletion of a record is indicated by zeroing the key 
f ie Ifl. 



KEY ENTRY (INDEX OR OVERFLOW) 
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TABLE 10.5.1 - PROGRAM PARAMETER BLOCK (PPB) 



BYTES PURPOSE OF FIELD 

Inplementatl on level 

No, 

1~12 Program naite- 

13-24 5-language name. 

25-31 Interpreter pack-ic- 

S?-'*? Interpreter nasie- 

<»4-55 Corapiler name. 

56-61 Coitpilation date. 

62-63 Priority class- 

64 Data segment for 

initiating message. 

65-67 S-program start address. 

68-69 Program segment 
table length. 

70-71 P.S.T. location. 

72-73 Data segment table 
74-75 CS-T. location. 

76-77 TCB preset area 



78-79 TCB preset area 
address . 

80-81 (Partial)Stack length 

82-83 CCB preset area 

length . 
84-85 CCB preset area 

address. 



SIZE REF COMMEMS 

1 B 



12 


A 


12 


A 


7 


A 


12 


A 


12 


A 


6 


A 


2 


B 


1 


B 


3 


B 


2 


B 



2 
2 



2 
2 



Standarc 12 character 
file as in FPB . 
For documentation. 



For documentation. 

VYMMOO. 

See Table 4.2-1.2. 

fFF implies 
discard message- 

Se'gment\Oisp lacement- 

NO. of segments *6 



8 Logical record no. 
within this file. 

8 NO. of segTents ♦&. 

B Logical record no. 
within this file. 

B In by tes . 



B Byt e disol acement 
within PPB. 

B In by tes . 

B In bytes. 

B Logical record no 
within this file. 



PROGRAM PARAMETER BLOCK (PPB) 
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TABLE 10.5.1 - PROGRAM PARAMETER BLOCK (PPB) cont. 



BYTES PURPOSE OF FIELD SIZE REF COMMENTS 



86-37 TCB preset 2 B In bytes, 

extension length. 

88-89 Internal file name 2 B In bytes, 

block length- 

90-91 Internal file name 2 B Logical record within 

block address, this file. 

--- TCB preset area values. Variable length. 



PROGRAM PARAMETER BLOCK (PPB) cont. 
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TABLE 10.5.2 - PROGRAM SEGMENT DESCRIPTOR 



Byte ITPE CODE 



value = : ordinary code or data segirent 
tbytes 2*3 = inolies a zero 
filled Hork area) 

value = 1 J this read-write data segment 
is an FIB 

value = .2 t a dummy entry will be built in the 
segment table (bytes 2»3»4»5 = 0) 

value = 3 : uninitialised (garbage filled) work 
segment (bytes 2»3 = 0) 



Byte I FLAGS 

bit 0»l»2»3»'t»5 used by OS 

bit 6 Set = lock in aain store 

bit 7 Set = read-write segment 

(never set for code» must be set 
if bytes 2»3 = O) 



Bytes 2» 3 Relative record number within 

file at start of segment 



Bytes A»5 Length of segitent in bytes ♦ 



♦ For an ^ lO segment descriptor* byte 5 contains the 
segment number of the appropriate FP8 segfent. 



PROGRAM SEGMENT DESCRIPTOR 
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TABLE 10.5.3 - PROGRAM INTERNAL FILE NAME BLOCK ENTRY 



Byte OST index of FIB 

Byte 1 OST Index of FPB 

Bytes 2-29 Internal file name- 
Left justified and 
blank filled 
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APPENDIX A 



APPENDIX A - INDEX OF TERMS 



AVAILABLE TABLE 
AVR 

BAILIFF 

CCB 
CPA 
CT, C. TABLE 

DDR 
DFH 
DIAGCBUF 

DST 

EPAR 
ESCT 
EVICT 

FDR 
FIB 
FPB 

GLBU1 

GLOBAL 

GWA 

ICB 

IFIB 

IFNB 

INTERGLBL 

lODESC 

KFPB 

LOADER 
LOCKS 

MCH 
MIP 

NAMELIST 



Non disk Directory 

- Automatic Volume Recognition 

MCP Task 

- Code Control Block 

- Configuration Table 

Device Dependent Routine 

- Disk File Header 

- Global Diagnostics Buffer 

- Data Segment Table 

- Execution Parameter Area 

- Execution Scan Table 
Bailiff operation 

- Function Dependent Routine 
File Information Block 
File Parameter Block 

- Global MCP (Bailiff) Map 

- MCP tables 

- Global Work Area 

- Interpreter Control Block 

- Indexed File Information Block 
Internal File Name Block 

- Interpreter Global Work Area 
Input-Output Descriptor 

Key File Parmeter Block 

- MCP task 15 

- MCP task control 

- Master Communicate Handler 

- Master Interrupt Processor 

Disk Directory 



Section 


10 


.3 


.1 


8 


.2 


.2 


n 






6 


.3 




8 


.4. 


.1 


9 


.1 




6 


.3. 


.2 


10 


.3. 


,3 


7 


.4. 


.2 


6 


.3. 


,7 


7, 


.6. 


1 


7. 


.6 




7. 


.6. 


3 


6. 


,3. 


3 


8. 


.6 




8. 


,5 




7. 


6 




6. 


2 




7. 


1 




6. 


3. 


4 


8. 


7 




10. 


5 




7. 


1 




9. 


3 





!.5 



7,7 




7.6. 


2 


9.1 




9.2 
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APPENDIX A 



INDEX OF TERMS (CONT.) 



OPENCLOSE 

OVERLAY 

OVERLAYABLE 

PCB 

PHDMP 

PHT 

PINK LINK 

PPB 

RESTORE 
ROUGH TABLE 
RS 

SAT 

SCL 

SD 

S-FLAGS 

SIWA 

SLICE 

SWAP 

TASK 

TASK. TABLE 
TCB 
THRASHING 

VERSION. INFO 

VM 

VMWA 

WAKT 



MCP slice 17 

Virtual Memory Operation 

Area of Memory 

Program Control Block 
Peripheral Handling Dump Area 
Peripheral Handling Table 
Slice Memory Structure 
Program Parameter Block 

Bailiff Operation 
Key File Area 
Slice Descriptor 

Slice Address Table 
System Control Language 
Segment Descriptor 
DDR status 

S-Interpreter Work Area 
Area of Memory 
Virtual Memory Operation 

Independent Runner 
Logical Task Information 
Task Control Block 
System State 

Global MCP Table 

Virtual Memory 

Virtual Memory Work Area 

Wait Key Table 



Section 


9. 


1 




7. 


5.: 


2 


6. 


4 




6. 


3. 


5 


7. 


2 




9. 


2 




6. 


3 




10. 


5 




7. 


6. 


3 


lo. 


4 




6. 


,3 




6. 


.2 




7. 


.7 




6, 


.4 




9. 


.2 




8 


.3 




6 


.3. 


,1 


7 


.6. 


,3 


8 


• 




8 


.2 




6 


.3 


.6 


7 


.5 


.3 


7 


.3 




7 


.5 


.2 


7 


.5 


.2 



7.6 
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